Skip to main content
PUT
Replace a contact
This endpoint performs a full replacement of a contact record using HTTP PUT semantics. Every field you provide overwrites the stored value, and any field you omit will be cleared. Use this endpoint when a contact’s email address, name, or phone number changes and needs to be updated in full. Note that the buyer_external_id association is immutable – a contact always belongs to the buyer it was created for and this relationship cannot be changed via a replace operation. To update only a subset of fields, retrieve the current contact first using the Retrieve contact endpoint, apply your changes to the returned payload, and submit the complete merged object to this endpoint.
This is a full replacement operation using PUT semantics. Any field you omit will be cleared, not preserved. Always retrieve the current contact record before calling this endpoint if you are making a partial update.
Email updates take effect immediately. Any new Tilta communications generated after this call will be sent to the updated email address. Previously sent communications are not resent.

Authorizations

Authorization
string
header
required

Your Tilta API key, sent as Bearer <key>.

Path Parameters

external_id
string
required

Unique identifier of a contact.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$

Body

application/json
salutation
enum<string> | null
required

Contact salutation. Send null to clear.

Available options:
MR,
MS,
OTHER
first_name
string | null
required

Contact first name. Send null to clear.

last_name
string | null
required

Contact last name. Send null to clear.

email
string<email> | null
required

Contact email. Send null to clear.

phone
string | null
required

Contact phone number (+491711010101). Send null to clear.

Example:

"+491711010101"

assign_to_all_invoices
boolean
required

Whether this contact should automatically be assigned to all invoices created for the buyer.

address
object | null
required

Contact's address. Send null to clear.

Response

Contact response payload.

external_id
string
required

Unique identifier of a contact.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
buyer_external_id
string
required

External identifier of the buyer this contact belongs to.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
assign_to_all_invoices
boolean
required

Whether this contact should automatically be assigned to all invoices created for the buyer.

created_at
number
required

Timestamp indicating when the contact was created (unix time in seconds).

Example:

1582896122

updated_at
number
required

Timestamp indicating the last time the contact was updated (unix time in seconds).

Example:

1582896122

salutation
enum<string> | null

Contact salutation.

Available options:
MR,
MS,
OTHER
first_name
string | null

Contact first name.

last_name
string | null

Contact last name.

email
string<email> | null

Contact email.

phone
string | null

Contact phone number in E.164 format (e.g. +491711010101).

Example:

"+491711010101"

address
object | null

Contact's address.