Skip to main content
Server path: /segment-destinations | Type: Application | PCID required: Yes

Tools

ToolDescription
segment_destinations_create_destinationCreate Destination
segment_destinations_create_destination_subscriptionCreate Destination Subscription
segment_destinations_create_filter_for_destinationCreate Filter for Destination
segment_destinations_delete_destinationDelete Destination
segment_destinations_get_advanced_sync_schedule_from_warehouseGet Advanced Sync Schedule from Warehouse
segment_destinations_get_destinationGet Destination
segment_destinations_get_egress_failed_metrics_from_delivery_overviewGet Egress Failed Metrics from Delivery Overview
segment_destinations_get_egress_success_metrics_from_delivery_overviewGet Egress Success Metrics from Delivery Overview
segment_destinations_get_filter_in_destinationGet Filter in Destination
segment_destinations_get_filtered_at_destination_metrics_from_delivery_overviewGet Filtered At Destination Metrics from Delivery Overview
segment_destinations_get_filtered_at_source_metrics_from_delivery_overviewGet Filtered At Source Metrics from Delivery Overview
segment_destinations_get_ingress_failed_metrics_from_delivery_overviewGet Ingress Failed Metrics from Delivery Overview
segment_destinations_get_ingress_success_metrics_from_delivery_overviewGet Ingress Success Metrics from Delivery Overview
segment_destinations_get_subscription_from_destinationGet Subscription from Destination
segment_destinations_list_delivery_metrics_summary_from_destinationList Delivery Metrics Summary from Destination
segment_destinations_list_destinationsList Destinations
segment_destinations_list_filters_from_destinationList Filters from Destination
segment_destinations_list_selective_syncs_from_warehouse_and_sourceList Selective Syncs from Warehouse And Source
segment_destinations_list_subscriptions_from_destinationList Subscriptions from Destination
segment_destinations_list_syncs_from_warehouseList Syncs from Warehouse
segment_destinations_list_syncs_from_warehouse_and_sourceList Syncs from Warehouse And Source
segment_destinations_preview_destination_filterPreview Destination Filter
segment_destinations_remove_filter_from_destinationRemove Filter from Destination
segment_destinations_remove_subscription_from_destinationRemove Subscription from Destination
segment_destinations_replace_advanced_sync_schedule_for_warehouseReplace Advanced Sync Schedule for Warehouse
segment_destinations_update_destinationUpdate Destination
segment_destinations_update_filter_for_destinationUpdate Filter for Destination
segment_destinations_update_selective_sync_for_warehouseUpdate Selective Sync for Warehouse
segment_destinations_update_subscription_for_destinationUpdate Subscription for Destination

segment_destinations_create_destination

Create Destination Parameters:
ParameterTypeRequiredDefaultDescription
enabledbooleanNoWhether this Destination should receive data.
metadataIdstringYesThe id of the metadata to link to the new Destination.
namestringNoDefines the display name of the Destination. Config API note: equal to displayName.
settingsobjectYesAn object that contains settings for the Destination based on the “required” and “advanced” settings present in the Destination metadata. Config API note: equal to config.
sourceIdstringYesThe id of the Source to connect to this Destination instance. Config API note: analogous to parent.

segment_destinations_create_destination_subscription

Create Destination Subscription Parameters:
ParameterTypeRequiredDefaultDescription
destinationIdstringYesDestination Id
actionIdstringYesThe associated action id the subscription should trigger.
enabledbooleanYesIs the subscription enabled.
modelIdstringNoWhen creating a Reverse ETL connection, indicates the Model being used to extract data.
namestringYesA user-defined name for the subscription.
settingsobjectNoThe fields used for configuring this action.
triggerstringYesThe FQL statement.

segment_destinations_create_filter_for_destination

Create Filter for Destination Parameters:
ParameterTypeRequiredDefaultDescription
destinationIdstringYesDestination Id
actionsobject[]YesActions for the Destination filter.
descriptionstringNoThe description of the filter.
enabledbooleanYesWhen set to true, the Destination filter is active.
ifstringYesThe filter’s condition.
sourceIdstringYesThe id of the Source associated with this filter.
titlestringYesThe title of the filter.

segment_destinations_delete_destination

Delete Destination Parameters:
ParameterTypeRequiredDefaultDescription
destinationIdstringYesDestination Id

segment_destinations_get_advanced_sync_schedule_from_warehouse

Get Advanced Sync Schedule from Warehouse Parameters:
ParameterTypeRequiredDefaultDescription
warehouseIdstringYesWarehouse Id

segment_destinations_get_destination

Get Destination Parameters:
ParameterTypeRequiredDefaultDescription
destinationIdstringYesDestination Id

segment_destinations_get_egress_failed_metrics_from_delivery_overview

Get Egress Failed Metrics from Delivery Overview Parameters:
ParameterTypeRequiredDefaultDescription
sourceIdstringYesThe sourceId for the Workspace. This parameter exists in beta.
destinationConfigIdstringYesThe id tied to a Workspace Destination. This parameter exists in beta.
startTimestringYesThe ISO8601 formatted timestamp corresponding to the beginning of the requested time frame, inclusive. This parameter exists in beta.
endTimestringYesThe ISO8601 formatted timestamp corresponding to the end of the requested time frame, noninclusive. This parameter exists in beta.
groupBystring[]NoA comma-delimited list of strings representing one or more dimensions to group the result by. Valid options are: event Name, event Type, discard Reason, app Version, subscription Id, activationId, audienceId, and spaceId. This parameter exists in beta.
granularitystringYesThe size of each bucket in the requested window. Based on the granularity chosen, there are restrictions on the time range you can query: Minute: - Max time range: 4 hours - Oldest possible start time: 48 hours in the past Hour: - Max Time range: 14 days - Oldest possible start time: 30 days in the past Day: - Max time range: 30 days - Oldest possible start time: 30 days in the past This parameter exists in beta.
filterobjectNoAn optional filter for event Name, event Type, discard Reason, app Version, subscription Id, activationId, audienceId, and/or spaceId that can be applied in addition to a group By. This parameter exists in beta.
paginationobjectNoParams to specify the page cursor and count. This parameter exists in beta.

segment_destinations_get_egress_success_metrics_from_delivery_overview

Get Egress Success Metrics from Delivery Overview Parameters:
ParameterTypeRequiredDefaultDescription
sourceIdstringYesThe sourceId for the Workspace. This parameter exists in beta.
destinationConfigIdstringYesThe id tied to a Workspace Destination. This parameter exists in beta.
startTimestringYesThe ISO8601 formatted timestamp corresponding to the beginning of the requested time frame, inclusive. This parameter exists in beta.
endTimestringYesThe ISO8601 formatted timestamp corresponding to the end of the requested time frame, noninclusive. This parameter exists in beta.
groupBystring[]NoA comma-delimited list of strings representing one or more dimensions to group the result by. Valid options are: event Name, event Type, discard Reason, app Version, subscription Id, activationId, audienceId, and spaceId. This parameter exists in beta.
granularitystringYesThe size of each bucket in the requested window. Based on the granularity chosen, there are restrictions on the time range you can query: Minute: - Max time range: 4 hours - Oldest possible start time: 48 hours in the past Hour: - Max Time range: 14 days - Oldest possible start time: 30 days in the past Day: - Max time range: 30 days - Oldest possible start time: 30 days in the past This parameter exists in beta.
filterobjectNoAn optional filter for event Name, event Type, discard Reason, appVersion, subscription Id, activationId, audienceId, or spaceId that can be applied in addition to a group By. If you would like to view retry attempts for a successful delivery, you can filter discard Reason from successes.attempt.1 through successes.attempt.10. This parameter exists in beta.
paginationobjectNoParams to specify the page cursor and count. This parameter exists in beta.

segment_destinations_get_filter_in_destination

Get Filter in Destination Parameters:
ParameterTypeRequiredDefaultDescription
destinationIdstringYesDestination Id
filterIdstringYesFilter Id

segment_destinations_get_filtered_at_destination_metrics_from_delivery_overview

Get Filtered At Destination Metrics from Delivery Overview Parameters:
ParameterTypeRequiredDefaultDescription
sourceIdstringYesThe sourceId for the Workspace. This parameter exists in beta.
destinationConfigIdstringYesThe id tied to a Workspace Destination. This parameter exists in beta.
startTimestringYesThe ISO8601 formatted timestamp corresponding to the beginning of the requested time frame, inclusive. This parameter exists in beta.
endTimestringYesThe ISO8601 formatted timestamp corresponding to the end of the requested time frame, noninclusive. This parameter exists in beta.
groupBystring[]NoA comma-delimited list of strings representing one or more dimensions to group the result by. Valid options are: event Name, event Type, discard Reason, app Version, subscription Id, activationId, audienceId, and spaceId. This parameter exists in beta.
granularitystringYesThe size of each bucket in the requested window. Based on the granularity chosen, there are restrictions on the time range you can query: Minute: - Max time range: 4 hours - Oldest possible start time: 48 hours in the past Hour: - Max Time range: 14 days - Oldest possible start time: 30 days in the past Day: - Max time range: 30 days - Oldest possible start time: 30 days in the past This parameter exists in beta.
filterobjectNoAn optional filter for event Name, event Type, discard Reason, app Version, subscription Id, activationId, audienceId, and/or spaceId that can be applied in addition to a group By. This parameter exists in beta.
paginationobjectNoParams to specify the page cursor and count. This parameter exists in beta.

segment_destinations_get_filtered_at_source_metrics_from_delivery_overview

Get Filtered At Source Metrics from Delivery Overview Parameters:
ParameterTypeRequiredDefaultDescription
sourceIdstringYesThe sourceId for the Workspace. This parameter exists in beta.
startTimestringYesThe ISO8601 formatted timestamp corresponding to the beginning of the requested time frame, inclusive. This parameter exists in beta.
endTimestringYesThe ISO8601 formatted timestamp corresponding to the end of the requested time frame, noninclusive. This parameter exists in beta.
groupBystring[]NoA comma-delimited list of strings representing one or more dimensions to group the result by. Valid options are: event Name, event Type, discard Reason, and app Version. This parameter exists in beta.
granularitystringYesThe size of each bucket in the requested window. Based on the granularity chosen, there are restrictions on the time range you can query: Minute: - Max time range: 4 hours - Oldest possible start time: 48 hours in the past Hour: - Max Time range: 14 days - Oldest possible start time: 30 days in the past Day: - Max time range: 30 days - Oldest possible start time: 30 days in the past This parameter exists in beta.
filterobjectNoAn optional filter for event Name, event Type, discard Reason, and/or app Version that can be applied in addition to a group By. This parameter exists in beta.
paginationobjectNoOptional params to specify the page cursor and count. This parameter exists in beta.

segment_destinations_get_ingress_failed_metrics_from_delivery_overview

Get Ingress Failed Metrics from Delivery Overview Parameters:
ParameterTypeRequiredDefaultDescription
sourceIdstringYesThe sourceId for the Workspace. This parameter exists in beta.
startTimestringYesThe ISO8601 formatted timestamp corresponding to the beginning of the requested time frame, inclusive. This parameter exists in beta.
endTimestringYesThe ISO8601 formatted timestamp corresponding to the end of the requested time frame, noninclusive. This parameter exists in beta.
groupBystring[]NoA comma-delimited list of strings representing one or more dimensions to group the result by. Valid options are: event Name, event Type, discard Reason, and/or appVersion. This parameter exists in beta.
granularitystringYesThe size of each bucket in the requested window. Based on the granularity chosen, there are restrictions on the time range you can query: Minute: - Max time range: 4 hours - Oldest possible start time: 48 hours in the past Hour: - Max Time range: 14 days - Oldest possible start time: 30 days in the past Day: - Max time range: 30 days - Oldest possible start time: 30 days in the past This parameter exists in beta.
filterobjectNoAn optional filter for event Name, event Type, discard Reason, and/or app Version that can be applied in addition to a group By. This parameter exists in beta.
paginationobjectNoOptional params to specify the page cursor and count. This parameter exists in beta.

segment_destinations_get_ingress_success_metrics_from_delivery_overview

Get Ingress Success Metrics from Delivery Overview Parameters:
ParameterTypeRequiredDefaultDescription
sourceIdstringYesThe sourceId for the Workspace. This parameter exists in beta.
startTimestringYesThe ISO8601 formatted timestamp corresponding to the beginning of the requested time frame, inclusive. This parameter exists in beta.
endTimestringYesThe ISO8601 formatted timestamp corresponding to the end of the requested time frame, noninclusive. This parameter exists in beta.
groupBystring[]NoA comma-delimited list of strings representing one or more dimensions to group the result by. Valid options are: event Name, event Type, and/or app Version. This parameter exists in beta.
granularitystringYesThe size of each bucket in the requested window. Based on the granularity chosen, there are restrictions on the time range you can query: Minute: - Max time range: 4 hours - Oldest possible start time: 48 hours in the past Hour: - Max Time range: 14 days - Oldest possible start time: 30 days in the past Day: - Max time range: 30 days - Oldest possible start time: 30 days in the past This parameter exists in beta.
filterobjectNoAn optional filter for event Name, event Type, and/or app Version that can be applied in addition to a group By. This parameter exists in beta.
paginationobjectNoOptional params to specify the page cursor and count. This parameter exists in beta.

segment_destinations_get_subscription_from_destination

Get Subscription from Destination Parameters:
ParameterTypeRequiredDefaultDescription
destinationIdstringYesDestination Id
idstringYesThe id value

segment_destinations_list_delivery_metrics_summary_from_destination

List Delivery Metrics Summary from Destination Parameters:
ParameterTypeRequiredDefaultDescription
destinationIdstringYesDestination Id
sourceIdstringYesThe id of the Source linked to the Destination. Config API note: analogous to parent. This parameter exists in beta.
startTimestringNoFilter events that happened after this time. Defaults to: - 1 hour ago if granularity is MINUTE. - 7 days ago if granularity is HOUR. - 30 days ago if granularity is DAY. This parameter exists in beta.
endTimestringNoFilter events that happened before this time. Defaults to now if not set. This parameter exists in beta.
granularitystringNoThe granularity to filter metrics to. Either MINUTE, HOUR or DAY. Defaults to MINUTE if not set. This parameter exists in beta.

segment_destinations_list_destinations

List Destinations Parameters:
ParameterTypeRequiredDefaultDescription
paginationobjectNoRequired pagination params for the request. This parameter exists in v1.

segment_destinations_list_filters_from_destination

List Filters from Destination Parameters:
ParameterTypeRequiredDefaultDescription
destinationIdstringYesDestination Id
paginationobjectNoPagination options. This parameter exists in v1.

segment_destinations_list_selective_syncs_from_warehouse_and_source

List Selective Syncs from Warehouse And Source Parameters:
ParameterTypeRequiredDefaultDescription
warehouseIdstringYesWarehouse Id
sourceIdstringYesSource Id
paginationobjectNoDefines the pagination parameters. This parameter exists in v1.

segment_destinations_list_subscriptions_from_destination

List Subscriptions from Destination Parameters:
ParameterTypeRequiredDefaultDescription
destinationIdstringYesDestination Id
paginationobjectNoPagination options. This parameter exists in alpha.

segment_destinations_list_syncs_from_warehouse

List Syncs from Warehouse Parameters:
ParameterTypeRequiredDefaultDescription
warehouseIdstringYesWarehouse Id
paginationobjectNoDefines the pagination parameters. This parameter exists in v1.

segment_destinations_list_syncs_from_warehouse_and_source

List Syncs from Warehouse And Source Parameters:
ParameterTypeRequiredDefaultDescription
warehouseIdstringYesWarehouse Id
sourceIdstringYesSource Id
paginationobjectNoDefines the pagination parameters. This parameter exists in v1.

segment_destinations_preview_destination_filter

Preview Destination Filter Parameters:
ParameterTypeRequiredDefaultDescription
filterobjectYesThe filter to preview.
payloadobjectYesThe JSON payload to apply the filter to.

segment_destinations_remove_filter_from_destination

Remove Filter from Destination Parameters:
ParameterTypeRequiredDefaultDescription
destinationIdstringYesDestination Id
filterIdstringYesFilter Id

segment_destinations_remove_subscription_from_destination

Remove Subscription from Destination Parameters:
ParameterTypeRequiredDefaultDescription
destinationIdstringYesDestination Id
idstringYesThe id value

segment_destinations_replace_advanced_sync_schedule_for_warehouse

Replace Advanced Sync Schedule for Warehouse Parameters:
ParameterTypeRequiredDefaultDescription
warehouseIdstringYesWarehouse Id
enabledbooleanYesEnable to turn on an advanced sync schedule for the Warehouse.
scheduleobjectNoThe full sync schedule for the Warehouse.

segment_destinations_update_destination

Update Destination Parameters:
ParameterTypeRequiredDefaultDescription
destinationIdstringYesDestination Id
enabledbooleanNoWhether this Destination should receive data.
namestringNoDefines the display name of the Destination. Config API note: equal to displayName.
settingsobjectNoAn optional object that contains settings for the Destination based on the “required” and “advanced” settings present in the Destination metadata. Config API note: equal to config.

segment_destinations_update_filter_for_destination

Update Filter for Destination Parameters:
ParameterTypeRequiredDefaultDescription
destinationIdstringYesDestination Id
filterIdstringYesFilter Id
actionsobject[]NoActions for this Destination filter.
descriptionstringNoThe description of this filter.
enabledbooleanNoWhen set to true, this Destination filter is active.
ifstringNoThe FQL if condition to update.
titlestringNoThe title to update.

segment_destinations_update_selective_sync_for_warehouse

Update Selective Sync for Warehouse Parameters:
ParameterTypeRequiredDefaultDescription
warehouseIdstringYesWarehouse Id
syncOverridesobject[]NoA list of sync schema overrides to apply to this Warehouse.

segment_destinations_update_subscription_for_destination

Update Subscription for Destination Parameters:
ParameterTypeRequiredDefaultDescription
destinationIdstringYesDestination Id
idstringYesThe id value
inputobjectYesA set of valid Destination input params required for updating.