Skip to main content
PUT
Sync an engagement

Authorizations

Authorization
string
header
default:<organization-api-token>
required

Organization integration token from Siro admin (Person icon → API Tokens). Send Authorization: Bearer . This is not the OAuth access token used with api.siro.ai user-scoped endpoints.

Body

application/json
externalId
string
required

The ID of the engagement in the external system

direction
enum<string> | null

The direction of the engagement (INBOUND/OUTBOUND)

Available options:
INBOUND,
OUTBOUND
content
string | null

The content of the engagement

subject
string | null

The subject of the engagement

startTime
string | null

start dateTime of the engagement in UTC.

startTimeLocalized
string | null

Localized dateTime of the engagement, without timezone info. When present, the frontend will display this as-is without timezone conversion, overriding startTime for display purposes.

endTime
string | null

end dateTime of the engagement

remoteCreatedAt
string | null

external engagement creation datetime

remoteUpdatedAt
string | null

external engagement update datetime

deletedAt
string<date-time> | null

The datetime when this record was deleted in the external system

engagementTypeId
string | null

Internal SIRO engagementTypeId override for this engagement. OPTIONAL -- only use if you know the internal value of the engagement type as it will override the engagementType object args.

engagementType
object | null

The type of this engagement

account
object | null

The associated account for this engagement. Note: supplying just an externalId will resolve to an already-synced account

engagementUsers
object[]

The users associated with this engagement

opportunity
object | null

The associated opportunity for this engagement. Note: supplying just an externalId will resolve to an already-synced opportunity

lead
object | null

The associated lead for this engagement

contact
object | null

The associated contact for this engagement. Note: supplying just an externalId will resolve to an already-synced contact

Response

200 - application/json

Sync an engagement

data
object
required