Register External Notification
Registers a notification that your own system already sent (e.g. an email to a customer) so staff can see it in Tillor. Tillor does not send anything. Idempotent on externalSource + externalReference: repeating the call returns the existing notification. Read registered notifications with GET /notifications?source=EXTERNAL. Requires the notifications:external:write permission.
ApiKeyAuthx-api-key<token>API key for authentication
organizationId*stringThe ID or slug of the organization
application/json- body
externalSource*stringNamespace of the system that sent the notification, e.g. 'mailchimp'.
^[a-z0-9][a-z0-9._-]*$1 <= length <= 64externalReference*stringYour own id for this notification. Unique per externalSource; repeating a create with the same pair returns the existing notification.
^[A-Za-z0-9._:/-]+$1 <= length <= 191name*stringShort staff-facing label, e.g. 'Booking confirmation'. Searchable; no personal data.
1 <= length <= 120customerId?string1 <= lengthinvoiceId?string1 <= lengthchannel*unknownemail*status*string"SENT""FAILED""BOUNCED""COMPLAINED"sentAt?stringdate-timereadAt?|nullclickedAt?|nullerrorMessage?|nullOK
application/json- response
curl -X POST 'https://api.tillor.eu/orgs/string/notifications/external' \ -H 'Content-Type: application/json' \ -d '{ "externalSource": "string", "externalReference": "string", "name": "string", "channel": "EMAIL", "email": { "to": "user@example.com", "subject": "string" }, "status": "SENT"}'nullGet Notification Delivery GET
Retrieves a notification delivery by its ID. Use include for relations.
Update External Notification PATCH
Updates the status, timestamps or content of an externally registered notification. Only notifications you registered yourself, unless you hold notifications:external:manage-others. Notifications sent by Tillor cannot be changed.