/segment-tracking | Type: Application | PCID required: Yes
Tools
segment_tracking_add_source_to_tracking_plan
Add Source to Tracking Plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
trackingPlanId | string | Yes | — | Tracking Plan Id |
sourceId | string | Yes | — | The id of the Source associated with the Tracking Plan. Config API note: analogous to sourceName. |
segment_tracking_create_tracking_plan
Create Tracking Plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
description | string | No | — | The Tracking Plan’s description. |
name | string | Yes | — | The Tracking Plan’s name. Config API note: equal to displayName. |
type | string | Yes | — | The Tracking Plan’s type. |
segment_tracking_create_transformation
Create Transformation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
allowProperties | string[] | No | — | Optional array for allowing properties from your events. |
destinationMetadataId | string | No | — | The optional Destination metadata id to be associated with the Transformation. |
drop | boolean | No | — | Optional boolean value if the Transformation should drop the event entirely when the if statement matches, ignores all other transforms. |
enabled | boolean | Yes | — | If the Transformation should be enabled. |
fqlDefinedProperties | object[] | No | — | Optional array for defining new properties in FQL. Currently limited to 1 property. |
hashPropertiesConfiguration | object | No | — | Optional object for hashing properties within an event. |
if | string | Yes | — | If statement (FQL) to match events. For standard event matchers, use the following: Track -> “event=’<eventName>’” Identify -> “type=‘identify’” Group -> “type=‘group‘“ |
name | string | Yes | — | The name of the Transformation. |
newEventName | string | No | — | Optional new event name for renaming events. Works only for ‘track’ event type. |
propertyRenames | object[] | No | — | Optional array for renaming properties collected by your events. |
propertyValueTransformations | object[] | No | — | Optional array for transforming properties and values collected by your events. Limited to 10 properties. |
sourceId | string | Yes | — | The Source to be associated with the Transformation. |
segment_tracking_delete_plan
Delete Tracking Plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
trackingPlanId | string | Yes | — | Tracking Plan Id |
segment_tracking_delete_transformation
Delete Transformation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
transformationId | string | Yes | — | Transformation Id |
segment_tracking_echo
Echo Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
message | string | Yes | — | Sets the response message field. The response contains this field’s entry. This parameter exists in alpha. |
delay | number | No | — | The desired response delay, in milliseconds. This parameter exists in alpha. |
triggerError | boolean | No | — | If true, returns an HTTP 4xx error that contains the string in message. This parameter exists in alpha. |
triggerMultipleErrors | boolean | No | — | If true, returns an HTTP 4xx error that contains the value of the message field in the error message array. This has no effect if the request sets triggerError. This parameter exists in alpha. |
triggerUnexpectedError | boolean | No | — | If true, triggers a 500 error. This has no effect if the request sets either triggerError or triggerMultipleErrors. This parameter exists in alpha. |
statusCode | number | No | — | Sets the HTTP status code to return. This parameter exists in alpha. |
segment_tracking_get_events_volume_from_workspace
Get Events Volume from Workspace Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
granularity | string | Yes | — | The size of each bucket in the requested window. This parameter exists in v1. |
startTime | string | Yes | — | The ISO8601 formatted timestamp that corresponds to the beginning of the requested time frame, inclusive. This parameter exists in v1. |
endTime | string | Yes | — | The ISO8601 formatted timestamp that corresponds to the end of the requested time frame, noninclusive. Segment recommends that you lag queries 1 minute behind clock time to reduce the risk for latency to impact the counts. This parameter exists in v1. |
groupBy | string[] | No | — | A comma-delimited list of strings that represents the dimensions to group the result by. The options are: eventName, eventType and source. This parameter exists in v1. |
sourceId | string[] | No | — | A list of strings which filters the results to the given SourceIds. This parameter exists in v1. |
eventName | string[] | No | — | A list of strings which filters the results to the given EventNames. This parameter exists in v1. |
eventType | string[] | No | — | A list of strings which filters the results to the given EventTypes. This parameter exists in v1. |
appVersion | string[] | No | — | A list of strings which filters the results to the given AppVersions. This parameter exists in v1. |
pagination | object | No | — | Pagination input for event volume by Workspace. This parameter exists in v1. |
segment_tracking_get_plan
Get Tracking Plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
trackingPlanId | string | Yes | — | Tracking Plan Id |
segment_tracking_get_transformation
Get Transformation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
transformationId | string | Yes | — | Transformation Id |
segment_tracking_list_rules_from_tracking_plan
List Rules from Tracking Plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
trackingPlanId | string | Yes | — | Tracking Plan Id |
pagination | object | No | — | Pagination options. This parameter exists in v1. |
segment_tracking_list_sources_from_tracking_plan
List Sources from Tracking Plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
trackingPlanId | string | Yes | — | Tracking Plan Id |
pagination | object | No | — | Pagination options. This parameter exists in v1. |
segment_tracking_list_tracking_plans
List Tracking Plans Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
type | string | No | — | Requests Tracking Plans of a certain type. If omitted, lists all types. This parameter exists in v1. |
pagination | object | No | — | Pagination options. This parameter exists in v1. |
segment_tracking_list_transformations
List Transformations Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pagination | object | No | — | Pagination options. This parameter exists in v1. |
segment_tracking_remove_rules_from_tracking_plan
Remove Rules from Tracking Plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
trackingPlanId | string | Yes | — | Tracking Plan Id |
rules | object[] | Yes | — | Rules to delete. This parameter exists in v1. |
segment_tracking_remove_source_from_tracking_plan
Remove Source from Tracking Plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
trackingPlanId | string | Yes | — | Tracking Plan Id |
sourceId | string | Yes | — | The id of the Source associated with the Tracking Plan. Config API note: analogous to sourceName. This parameter exists in v1. |
segment_tracking_replace_rules_in_tracking_plan
Replace Rules in Tracking Plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
trackingPlanId | string | Yes | — | Tracking Plan Id |
rules | object[] | Yes | — | Rules to replace. |
segment_tracking_update_rules_in_tracking_plan
Update Rules in Tracking Plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
trackingPlanId | string | Yes | — | Tracking Plan Id |
rules | object[] | No | — | Rules to update or insert. |
segment_tracking_update_tracking_plan
Update Tracking Plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
trackingPlanId | string | Yes | — | Tracking Plan Id |
description | string | No | — | The Tracking Plan’s description. |
name | string | No | — | The Tracking Plan’s name. Config API note: equal to displayName. |
segment_tracking_update_transformation
Update Transformation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
transformationId | string | Yes | — | Transformation Id |
allowProperties | string[] | No | — | Optional array for allowing properties from your events. |
destinationMetadataId | string | No | — | The optional Destination metadata to be associated with the Transformation. |
drop | boolean | No | — | Optional boolean value if the Transformation should drop the event entirely when the if statement matches, ignores all other transforms. |
enabled | boolean | No | — | If the Transformation should be enabled. |
fqlDefinedProperties | object[] | No | — | Optional array for updating properties defined in FQL. Currently limited to 1 property. |
hashPropertiesConfiguration | object | No | — | Optional object for hashing properties within an event. |
if | string | No | — | If statement (FQL) to match events. For standard event matchers, use the following: Track -> “event=’<eventName>’” Identify -> “type=‘identify’” Group -> “type=‘group‘“ |
name | string | No | — | The name of the Transformation. |
newEventName | string | No | — | Optional new event name for renaming events. Works only for ‘track’ event type. |
propertyRenames | object[] | No | — | Optional array for renaming properties collected by your events. |
propertyValueTransformations | object[] | No | — | Optional array for transforming properties and values collected by your events. Limited to 10 properties. |
sourceId | string | No | — | The optional Source to be associated with the Transformation. |

