Skip to content

Mark a contact in another product as the same person

POST
/products/{productId}/contacts/{id}/links
curl --request POST \
--url https://api.motenya.app/v1/products/example/contacts/example/links \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "otherProductId": "example", "otherContactId": "example" }'

Requires crm:write.

productId
required
string
>= 1 characters <= 64 characters
id
required
string
>= 1 characters <= 64 characters
Media typeapplication/json

A contact in another product the key may also use.

object
otherProductId
required
string
>= 1 characters <= 64 characters
otherContactId
required
string
>= 1 characters <= 64 characters

Example generated

{
"otherProductId": "example",
"otherContactId": "example"
}

Success

Media typeapplication/json
Array<object>
object
productId
required
string
>= 1 characters <= 64 characters
recordId
required
string
>= 1 characters <= 64 characters
name
required
string | null
matches
required

The emails or VAT number both records share.

Array<string>
linked
required

Someone marked the two as the same person.

boolean

Example generated

[
{
"productId": "example",
"recordId": "example",
"name": "example",
"matches": [
"example"
],
"linked": true
}
]

Invalid request

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Missing, invalid, revoked or expired API key

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Missing scope, API turned off, published article without publish scope, or account suspended

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Not found, or outside the knowledge bases this key may use

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Slug or translation already exists

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Rejected by validation (e.g. unknown language or category)

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Rate limited; see Retry-After

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Internal error