Callbacks

Manages event notification callbacks that are configured in Salesforce Marketing Cloud. A callback defines an endpoint that receives real-time notifications when specified system events occur, such as message delivery or data import completion. This table allows you to create, update, delete, and query callback definitions to automate event-driven workflows.

Table Specific Information

Select

Select all callbacks:

SELECT * FROM Callbacks

Retrieve a specific callback:

SELECT * FROM Callbacks WHERE CallbackId = 94766

Insert

To create a Callback, you will need to specify at least the CallbackName and Url column.

INSERT INTO [Callbacks] (CallbackName, Url) VALUES ('cb1', 'https://example.com')

Update

Callbacks may be modified by providing the CallbackId of the callback and issuing an UPDATE statement.

UPDATE [Callbacks] SET CallbackName = 'cb update' WHERE CallbackId = '34cd6cfe-5a21-4f3e-94c5-b6313a6954a4'

Delete

Callbacks may be deleted by providing the CallbackId of the callback and issuing a DELETE statement.

DELETE FROM [Callbacks] WHERE CallbackId = '43841979-7154-4fc4-9789-909dbba3a54f'

Columns


Name	Type	ReadOnly	References	Filters	Description
CallbackId [KEY]	String	False		=	Identifies the unique string value that represents the event notification callback within Salesforce Marketing Cloud. This system-generated identifier (Id) is used to register, track, and manage callbacks that are defined for API event notifications.
CallbackName	String	False			Specifies the name that defines the event notification callback. This user-assigned label is used to identify callbacks in administrative views and API responses and helps distinguish multiple notification configurations that can exist within an account.
Url	String	False			Defines the endpoint URL that the system calls when an event notification is triggered. This value must be a valid, reachable URL that receives HTTPS POST requests containing payload data for subscribed events.
MaxBatchSize	Integer	False			Indicates the maximum number of event notifications that can be included in a single callback batch. This value controls the payload size for each delivery cycle and helps balance throughput against network performance. The system enforces this limit to optimize event dispatch efficiency.
Status	String	False			Defines the current operational state of the event notification callback (for example, 'Active', 'Paused', or 'Disabled'). This field determines whether the callback is currently processing notifications or awaiting reactivation. Monitoring callback status helps ensure uninterrupted event delivery.
StatusReason	String	False			Provides a descriptive reason that explains the callback's current status. This field records contextual information, such as error responses or administrative actions, that is used to diagnose callback issues or justify configuration changes.