Skip to main content
DELETE
Delete a contact
Deleting a contact permanently removes them from the buyer’s communication recipients. After deletion, the contact will no longer receive any automated email communications from Tilta – including invoice notifications, payment reminders, and overdue alerts. This operation is irreversible; if you need the contact to receive communications again, you must create a new contact record. Use this endpoint when a contact person leaves the buyer’s organization or is no longer the appropriate recipient for payment communications.
Deletion is permanent and irreversible. If the deleted contact was the only contact for a buyer, that buyer will no longer receive any automated Tilta communications. Ensure the buyer has at least one other active contact before deleting the last one.
Deleting a contact does not affect the associated buyer record, their credit facility, or any existing orders and invoices. Only future automated communications to this contact are stopped.

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-_]+$

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.