Update contact by email

patch

https://api.omnisend.com/api/contacts

Updates the contact matching the provided email address.

Scopes:
contacts.write

Rate Limiting:
This endpoint is rate limited to 400 requests per minute.

Query Params

string

required

Contact email address

Body Params

Contact fields to update

Payload for creating or updating a contact.

address

string

Street, house number, apartment number.

birthdate

string

Contact birthdate in YYYY-MM-DD format

city

string

City

country

string

Country name. Used to derive ISO country code when countryCode is not provided

countryCode

string

ISO 3166-1 alpha-2 country code. Takes priority over country when both are provided

createdAt

string

Contact creation timestamp. If provided, stored as "externalCreated" custom property

customProperties

object

You can add your own custom properties. Read more in https://api-docs.omnisend.com/reference/contacts#custom-properties

firstName

string

Contact first name

gender

string

enum

Contact gender. m - male, f - female

Allowed:

identifiers

array of objects

Contact identifiers (email and/or phone)

identifiers

lastName

string

Contact last name

postalCode

string

Postal or zip code

state

string

State or region

200OK

400Request contains invalid or missing fields

401Authentication is missing or invalid

403Insufficient permissions for this operation

404Contact not found

409Contact identifier already exists

410API version has been retired

429Rate limit exceeded

500Unexpected error occurred