Skip to main content
POST
/
contacts
/
{contactId}
/
relations
Create a contact relation
curl --request POST \
  --url https://api.smokeball.com/contacts/{contactId}/relations \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json-patch+json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "relatedContactId": "b471682e-fa17-4e46-b7fe-9b2b8fdcb3c2",
  "businessRole": "Bookkeeper"
}
'
{
  "id": "<string>",
  "href": "<string>",
  "relation": "<string>",
  "method": "GET"
}

Documentation Index

Fetch the complete documentation index at: https://docs.smokeball.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

ā€‹
x-api-key
string
header
required
ā€‹
Authorization
string
header
required

Path Parameters

ā€‹
contactId
string
required

Body

ā€‹
relatedContactId
string | null

Unique identifier of the related contact.

Example:

"b471682e-fa17-4e46-b7fe-9b2b8fdcb3c2"

ā€‹
businessRole
string | null

Business role of related contact.

Only applicable for companies (not trusts).

Example:

"Bookkeeper"

Response

When request is accepted. Returns a 'Link' object.

ā€‹
id
string | null
ā€‹
href
string | null
ā€‹
relation
string | null
ā€‹
method
string | null
default:GET