Vantax AIDocs
POST

Contact Created Trigger

Fires when a new contact is created in the sub-account.

POSThttps://api.vantaxai.com/v1/workflows (trigger: contact.created)

Use the `contact.created` trigger to start a Workflow whenever a contact is added — whether through the API, a form submission, or an inbound call. Scope it with `config` filters such as `source` to only react to specific channels. When the event fires, the Workflow's `trigger_event` is populated with the contact payload shown below. Reference this trigger by setting `trigger.type` to `contact.created` on the Create Workflow endpoint.

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

  • trigger.typestringrequired

    Set to `contact.created` to use this trigger.

    example: contact.created

  • trigger.config.sourcestringoptional

    Only fire for contacts created via this source.

    websiteapiinbound_callimportmanual

    example: website

  • trigger.config.tag_idstringoptional

    Only fire for contacts created with this tag applied.

    example: tag_9f02

Request

curl -X POST https://api.vantaxai.com/v1/workflows (trigger: contact.created) \
  -H "Authorization: Bearer vx_live_3fa9c2..." \
  -H "Content-Type: application/json" \
  -d '{
  "trigger.type": "contact.created",
  "trigger.config.source": "website",
  "trigger.config.tag_id": "tag_9f02"
}'

Response

{
  "type": "contact.created",
  "occurred_at": "2026-02-02T08:12:00Z",
  "sub_account_id": "sub_8a1f4c2e",
  "data": {
    "contact_id": "ct_91ad22",
    "name": "Jordan Reyes",
    "phone": "+14155550142",
    "email": "jordan@example.com",
    "source": "website",
    "tags": ["tag_9f02"]
  }
}