Create a contact
POST
/products/{productId}/contacts
const url = 'https://api.motenya.app/v1/products/example/contacts';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"name":"example","emails":["example"],"phone":"example","language":"example","tags":["example"],"custom":"example","client":{"clientId":"example","role":"example"}}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.motenya.app/v1/products/example/contacts \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "example", "emails": [ "example" ], "phone": "example", "language": "example", "tags": [ "example" ], "custom": "example", "client": { "clientId": "example", "role": "example" } }'Needs a name or an email. An email already on another contact of the product fails with EMAIL_TAKEN.
Requires crm:write.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”productId
required
string
Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
name
string | null
emails
Primary first; normalized to lowercase. Unique within the product.
Array<string> | null
phone
string | null
language
string | null
tags
Array<string> | null
custom
Custom field values keyed by field key; null clears one. See GET /products/{productId}/custom-fields.
object | null
client
Link the new contact to a client straight away.
object
clientId
required
string
role
string | null
Example generated
{ "name": "example", "emails": [ "example" ], "phone": "example", "language": "example", "tags": [ "example" ], "custom": "example", "client": { "clientId": "example", "role": "example" }}Responses
Section titled “Responses”Success
Media typeapplication/json
object
id
required
string
name
required
string | null
emails
required
Array<string>
phone
required
string | null
language
required
string | null
tags
required
Array<string>
custom
required
object
key
additional properties
source
required
string
externalId
required
string | null
clients
required
Array<object>
object
clientId
required
string
name
required
string
kind
required
string
role
required
string | null
createdAt
required
string
updatedAt
required
string
key
additional properties
Example
{ "clients": [ { "kind": "company" } ]}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