API ReferenceContactsCreate Contact

Create Contact

Create a new contact profile globally in the directory. Enforces contact quota limits.

POSThttps://wapi.simplysend.email/web-setup/contacts

email^*

string

Email address of the contact.* Either email or phone must be provided.

phone^*

string

Phone number of the contact.* Either email or phone must be provided.

firstName

string

First name of the contact.

lastName

string

Last name of the contact.

globalStatus

string

Global email/phone delivery status. Valid values: 'active', 'unsubscribed', 'bounced', 'complained'. Defaults to 'active'.

consentMethod

string

Consent acquisition method. Valid values: 'double_opt_in', 'single_opt_in', 'imported', 'web_form', 'implicit_api', 'other'.

consentDetails

string

Detailed description of the consent flow or audit notes (e.g. 'Checked physical agreement box during customer onboarding').

customFields

object

Custom key-value JSON properties for segmentation.

RequestPOST

Response