Skip to main content
POST
/
v1
/
contacts
Create a new contact
curl --request POST \
  --url https://api.distranmail.com/v1/contacts \
  --header 'Content-Type: application/json' \
  --data '{
  "first_name": "<string>",
  "last_name": "<string>",
  "emails": [
    {
      "type": "EMAIL_TYPE_UNSPECIFIED",
      "email": "<string>"
    }
  ],
  "phones": [
    {
      "type": "PHONE_TYPE_UNSPECIFIED",
      "phone": "<string>"
    }
  ],
  "social_profiles": [
    {
      "type": "SOCIAL_PROFILE_TYPE_UNSPECIFIED",
      "username": "<string>"
    }
  ],
  "metadata": {}
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "first_name": "<string>",
  "last_name": "<string>",
  "display_name": "<string>",
  "company": "<string>",
  "title": "<string>",
  "emails": [
    {
      "id": "<string>",
      "type": "EMAIL_TYPE_UNSPECIFIED",
      "email": "<string>"
    }
  ],
  "phones": [
    {
      "id": "<string>",
      "type": "PHONE_TYPE_UNSPECIFIED",
      "phone": "<string>"
    }
  ],
  "social_profiles": [
    {
      "id": "<string>",
      "type": "SOCIAL_PROFILE_TYPE_UNSPECIFIED",
      "username": "<string>"
    }
  ],
  "tags": [
    "<string>"
  ],
  "metadata": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "last_contacted_at": "2023-11-07T05:31:56Z"
}

Body

application/json
first_name
string
last_name
string
emails
object[]
phones
object[]
social_profiles
object[]
metadata
object

Response

200 - application/json

Contact created successfully

id
string<uuid>
required
created_at
string<date-time>
required
account_id
string<uuid>
first_name
string
Maximum length: 100
last_name
string
Maximum length: 100
display_name
string
Maximum length: 200
company
string
Maximum length: 200
title
string
Maximum length: 200
emails
object[]
phones
object[]
social_profiles
object[]
tags
string[]
metadata
object
updated_at
string<date-time>
last_contacted_at
string<date-time>
I