Skip to content

Commit 2a794c9

Browse files
authored
Merge pull request #4808 from segmentio/lizkane222-patch-18
Update actions.md Copying Classic Destination Filters to Actions Dest…
2 parents 64d24b1 + 7bea65d commit 2a794c9

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

src/connections/destinations/actions.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,20 @@ Moving from a classic destination to an actions-based destination is a manual pr
7575
5. Verify that data is flowing from the development or test source to the partner tool.
7676
6. Repeat the steps above with your production source.
7777

78+
### Migrate your destination filters from the classic destination to the actions destination
79+
80+
> warning ""
81+
> You can only migrate your destination filters using the Public API if you're on the business tier plan. This functionality isn't available in the Segment app.
82+
83+
To migrate your destination filters to your actions destination from the classic destination:
84+
1. Send a request to the Public API endpoint.
85+
- Use [List Filters from Destination](https://docs.segmentapis.com/tag/Destination-Filters#operation/listFiltersFromDestination){:target="_blank"} . The `destinationId` can be found in the URL while viewing the destination in your Segment workspace.
86+
2. Grab the response and parse through the `data.filters` object. Each object returned inside the `data.filters` object is an individual filter associated with the specified destination.
87+
4. Send individual `POST` requests to the Public API endpoint.
88+
- Use [Create Filter for Destination](https://docs.segmentapis.com/tag/Destination-Filters/#operation/createFilterForDestination){:target="_blank"} , for each of the filters from step 2.
89+
- Specify the Actions `destinationId`, found in the URL when viewing that destination. The body of the request is the individual filters from step 2.
90+
6. If the bodies of those requests don't already include the field `"enabled": true`, make sure to enable each of those filters after you create them.
91+
7892
### Migrate to an actions-based destination using Destination Filters
7993
For a more comprehensive migration from a classic destination to an actions-based destination, follow the steps outlined below. This implementation strategy is only available for customers on a Segment Business Tier plan with access to [Destination Filters](/docs/connections/destinations/destination-filters/). By adding additional line of defense with Destination Filters, you remove the possibility of duplicate events or dropped events and ensure that events sent before/after a specified `received_at` timestamp are sent to each destination.
8094

0 commit comments

Comments
 (0)