POST

Create Contact

Creates a new contact in the specified sub-account.

POSThttps://api.vantaxai.com/v1/contacts

A new contact defaults to `active` status. Tags must already exist in the sub-account — see Create Contact Tag to define them first.

Headers

Authorizationstringrequired
Bearer authentication with your secret API key.
example: Bearer vx_live_3fa9c2…
Content-Typestringrequired
Must be application/json for requests with a body.
example: application/json

Body Parameters

first_namestringrequired
The contact's first name.
example: Jordan
last_namestringrequired
The contact's last name.
example: Avery
emailstringrequired
The contact's email address.
example: jordan.avery@example.com
phonestringrequired
The contact's phone number in E.164 format.
example: +14155550142
sub_account_idstringrequired
Sub-account that will own the contact.
example: sub_8a1f4c2e
statusstringoptional
Initial status. Defaults to active.
activedeactivated
example: active
addressstringoptional
Mailing or physical address.
example: 200 Market St, San Francisco, CA
lead_sourcestringoptional
Where this contact originated.
example: website
tagsstring[]optional
Tag names to apply to the contact.
example: ["vip", "newsletter"]

Request

curl -X POST https://api.vantaxai.com/v1/contacts \
  -H "Authorization: Bearer vx_live_3fa9c2..." \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jordan",
    "last_name": "Avery",
    "email": "jordan.avery@example.com",
    "phone": "+14155550142",
    "sub_account_id": "sub_8a1f4c2e",
    "lead_source": "website",
    "tags": ["vip"]
  }'

const res = await fetch("https://api.vantaxai.com/v1/contacts", {
  method: "POST",
  headers: {
    Authorization: "Bearer vx_live_3fa9c2...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    first_name: "Jordan",
    last_name: "Avery",
    email: "jordan.avery@example.com",
    phone: "+14155550142",
    sub_account_id: "sub_8a1f4c2e",
    tags: ["vip"],
  }),
});
const { data: contact } = await res.json();

const contact = await vantax.contacts.create({
  firstName: "Jordan",
  lastName: "Avery",
  email: "jordan.avery@example.com",
  phone: "+14155550142",
  subAccountId: "sub_8a1f4c2e",
  tags: ["vip"],
});

contact = vantax.contacts.create(
    first_name="Jordan",
    last_name="Avery",
    email="jordan.avery@example.com",
    phone="+14155550142",
    sub_account_id="sub_8a1f4c2e",
    tags=["vip"],
)

Response

{
  "success": true,
  "message": "Contact created successfully",
  "data": {
    "id": "ct_9b21d3",
    "first_name": "Jordan",
    "last_name": "Avery",
    "email": "jordan.avery@example.com",
    "phone": "+14155550142",
    "status": "active",
    "address": null,
    "lead_source": "website",
    "tags": ["vip"],
    "created_at": "2026-01-14T10:30:00Z"
  }
}

{
  "success": false,
  "message": "Validation failed",
  "errors": [
    { "field": "first_name", "message": "first_name is required" }
  ]
}