Create a contact

POST

/api/v1/contacts

curl --request POST \
  --url https://renotify.app/api/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "Jane Doe", "phone": "+15551234567", "email": "jane@example.com", "external_id": "contact_123", "source": "hubspot", "data": { "city": "Boston", "plan": "Gold" }, "marketing_consent": { "whatsapp": true, "email": false } }'

Authorizations

• default

Request Body^required

Media typeapplication/json

object

name

required

The contact name.

string

Example

Jane Doe

phone

The contact phone number.

string

nullable

Example

+15551234567

email

The contact email address.

string

nullable

Example

jane@example.com

external_id

An external system identifier.

string

nullable

Example

contact_123

source

The source system name.

string

nullable

Example

hubspot

data

Additional custom field values.

object

Example

{
  "city": "Boston",
  "plan": "Gold"
}

marketing_consent

Marketing consent per channel (whatsapp, sms, email, rcs, telegram, messenger, instagram, browser_push). Omitted channels are unchanged.

object

Example

{
  "whatsapp": true,
  "email": false
}

Responses