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. For instructions, see Create an Authenticated Server-to-Server Connection.
Request body

You can include multiple event types in a request. For more information, see the recommended schema.

Request parameters

Parameter	Description
`eventId`	A unique ID for each event
`dateTime`	Timestamp must be in ISO8601 format `YYYY-MM-DD'T'HH:mm:ss.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 either `profile` or `engagement`

Response body

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