Post Data from an Authenticated Server-to-Server Connection

Use the POST method to send event data through an authenticated server-to-server connection. Use a server-to-server connection when your server already collects engagement data that you want to forward to Data Cloud or when you require an authenticated connection.

URI: /server/events/{appSourceId}.

Retrieve the {appSourceId} after you create a server-to-server connection in Data Cloud.

Available since release: Salesforce v63.0
Formats: REST
HTTP methods: POST
Authentication: Authenticated connections require a connected app. See Create an Authenticated Server-to-Server Connection for instructions.
Request body

You can include multiple event types in a request. See the recommended schema for details.

Request parameters

Parameter	Description
`eventId`	A unique ID for each event
`dateTime`	Timestamp must be in ISO8601 format YYYY-MM-DD'T'HH:mm.SSS'Z'
`sessionId`	Same as the deviceId
`deviceId`	A unique ID, stored in a cookie, for the device from which the request is made
`eventType`	Contains the developerName value used in the definition of an event schema
`category`	Must be profile or engagement

Response body

Code	Description
`204`	No Content (payload posted)
`400`	Bad Request
`401`	Unauthorized
`500`	Server Error