Add a contact to an account

POST/accounts/{storeId}/contacts

Requires scope: write:contacts

Parameters

Parameter	In	Type	Description
`storeId`required	path	string
`Idempotency-Key`required	header	string	Stable logical request ID required for every machine mutation; exact retries replay and changed inputs conflict.

Request body

Field	Type	Allowed values	Description
`first_name`	string	any string
`last_name`	string	any string
`name`	string	any string
`role`	string	any string
`email`	string	any string
`email_permission_status`	string	`unknownconfirmedwithdrawn`	Confirmed only when the recipient gave permission; discovery or verification is insufficient.
`email_permission_source`	string	`direct_requestwebsite_formeventexisting_relationshipimported_consentother`
`email_permission_confirmed_at`	string	any string
`email_permission_note`	string	any string

Responses

Status	Description
`201`	Created
`400`	Invalid body
`401`	Missing or invalid API key
`403`	Key lacks the required scope
`404`	Account not found
`429`	Rate limit exceeded (see Retry-After)

Is this page helpful?

Request

curl -X POST "https://vergio.ai/api/v1/accounts/b7c9a2e1-0000-4000-8000-000000000000/contacts" \
  -H "Authorization: Bearer $VERGIO_API_KEY" \
  -H "Idempotency-Key: replace-with-a-stable-request-id" \
  -H "Content-Type: application/json" \
  -d '{
  "first_name": "string",
  "last_name": "string",
  "name": "string",
  "role": "string",
  "email": "string",
  "email_permission_status": "unknown",
  "email_permission_source": "direct_request",
  "email_permission_confirmed_at": "2026-07-06T12:00:00Z",
  "email_permission_note": "string"
}'

Response (201)

{
  "contact": {
    "id": "b7c9a2e1-0000-4000-8000-000000000000",
    "storeId": "b7c9a2e1-0000-4000-8000-000000000000",
    "name": "string",
    "firstName": "string",
    "lastName": "string",
    "role": "string",
    "email": "string",
    "emailStatus": "string",
    "source": "string"
  }
}