← Tools Reference

Segment

Segment integration (Data, Marketing). Imported from open-connector.

API key7 toolshttps://api.segment.io/v1
POST
segment_identify
Send a Segment Identify call to record user traits.

/identify

8 parameters
ParamTypeRequiredDescription
userIdstringoptionalUnique identifier for the user in your database.
anonymousIdstringoptionalPseudo-unique anonymous identifier for the user.
contextobjectoptionalSegment context object with extra information about the event.
integrationsobjectoptionalSegment destination flags keyed by destination name.
timestampstringoptionalTimestamp when the message took place, in ISO 8601 format.
sentAtstringoptionalTimestamp when the message was sent to Segment, in ISO 8601 format.
messageIdstringoptionalUnique message identifier used by Segment for deduplication.
traitsobjectoptionalFree-form traits associated with the user.
POST
segment_track
Send a Segment Track call to record one user event.

/track

9 parameters
ParamTypeRequiredDescription
userIdstringoptionalUnique identifier for the user in your database.
anonymousIdstringoptionalPseudo-unique anonymous identifier for the user.
contextobjectoptionalSegment context object with extra information about the event.
integrationsobjectoptionalSegment destination flags keyed by destination name.
timestampstringoptionalTimestamp when the message took place, in ISO 8601 format.
sentAtstringoptionalTimestamp when the message was sent to Segment, in ISO 8601 format.
messageIdstringoptionalUnique message identifier used by Segment for deduplication.
eventstringrequiredName of the action the user performed.
propertiesobjectoptionalFree-form properties associated with the event.
POST
segment_page
Send a Segment Page call to record a website page view.

/page

9 parameters
ParamTypeRequiredDescription
userIdstringoptionalUnique identifier for the user in your database.
anonymousIdstringoptionalPseudo-unique anonymous identifier for the user.
contextobjectoptionalSegment context object with extra information about the event.
integrationsobjectoptionalSegment destination flags keyed by destination name.
timestampstringoptionalTimestamp when the message took place, in ISO 8601 format.
sentAtstringoptionalTimestamp when the message was sent to Segment, in ISO 8601 format.
messageIdstringoptionalUnique message identifier used by Segment for deduplication.
namestringoptionalOptional page name.
propertiesobjectoptionalFree-form properties associated with the page.
POST
segment_screen
Send a Segment Screen call to record a mobile app screen view.

/screen

9 parameters
ParamTypeRequiredDescription
userIdstringoptionalUnique identifier for the user in your database.
anonymousIdstringoptionalPseudo-unique anonymous identifier for the user.
contextobjectoptionalSegment context object with extra information about the event.
integrationsobjectoptionalSegment destination flags keyed by destination name.
timestampstringoptionalTimestamp when the message took place, in ISO 8601 format.
sentAtstringoptionalTimestamp when the message was sent to Segment, in ISO 8601 format.
messageIdstringoptionalUnique message identifier used by Segment for deduplication.
namestringoptionalOptional screen name.
propertiesobjectoptionalFree-form properties associated with the screen.
POST
segment_group
Send a Segment Group call to associate a user with a group.

/group

9 parameters
ParamTypeRequiredDescription
userIdstringoptionalUnique identifier for the user in your database.
anonymousIdstringoptionalPseudo-unique anonymous identifier for the user.
contextobjectoptionalSegment context object with extra information about the event.
integrationsobjectoptionalSegment destination flags keyed by destination name.
timestampstringoptionalTimestamp when the message took place, in ISO 8601 format.
sentAtstringoptionalTimestamp when the message was sent to Segment, in ISO 8601 format.
messageIdstringoptionalUnique message identifier used by Segment for deduplication.
groupIdstringrequiredUnique identifier for the group in your database.
traitsobjectoptionalFree-form traits associated with the group.
POST
segment_alias
Send a Segment Alias call to associate one user identity with another.

/alias

7 parameters
ParamTypeRequiredDescription
userIdstringrequiredUnique identifier for the user in your database.
previousIdstringrequiredPrevious unique identifier for the user.
contextobjectoptionalSegment context object with extra information about the event.
integrationsobjectoptionalSegment destination flags keyed by destination name.
timestampstringoptionalTimestamp when the message took place, in ISO 8601 format.
sentAtstringoptionalTimestamp when the message was sent to Segment, in ISO 8601 format.
messageIdstringoptionalUnique message identifier used by Segment for deduplication.
POST
segment_batch
Send a Segment Batch call containing Identify, Group, Track, Page, or Screen items.

/batch

3 parameters
ParamTypeRequiredDescription
batcharrayrequiredSegment event items to send in this batch.
contextobjectoptionalSegment context object with extra information about the event.
integrationsobjectoptionalSegment destination flags keyed by destination name.