Tracking plan API
Use our tracking plan API to programmatically manage your tracking plans.
The Tracking Plan API lets you build applications or scripts on top of RudderStack’s Tracking Plan capabilities. You can use the Tracking Plan API to:
- Create/update/fetch tracking plans
- Define the tracking plan rules
- Connect a source to a tracking plan
This guide covers the details related to the usage of Tracking Plan API.
The following prerequisites must be met to use the Tracking Plan API successfully:
Set up a source-destination connection in RudderStack. For more details, refer to Quickstart guide.
Generate a Personal Access Token in the RudderStack dashboard to authenticate the API successfully.
RudderStack uses Basic Authentication for authenticating all API requests.
All the popular HTTP clients (e.g. CURL, Postman, HTTPie) have default support for Basic Authentication.
The Basic Authentication for this API requires a username and password, where:
- The username is the email address you used to sign up for RudderStack.
- The password is the personal access token generated previously.
For example, if the email address is
firstname.lastname@example.org and the personal access token is
1zl4GJkLu0HsBdrDK88NgYZzY2E, your request must have the following HTTP header:
Authorization: Basic bmFtZUBzdXJuYW1lLmNvbToxemw0R0prTHUwSHNCZHJESzg4TmdZWnpZMkU=
In case of the Invalid Authorization Header error, verify if the email address and the personal access token are valid.
Tracking Plan API usage
The Tracking Plan API is divided into the following sections depending on its usage:
|Tracking Plan API||Description|
|Tracking Plans||This section demonstrates all requests related to tracking plans, such as, creating, updating, upserting or fetching the tracking plans.|
|Tracking Plan Rules||This section demonstrates all requests related to events, such as, creating, updating, linking/unlinking or fetching events.|
|Source Tracking Plan Connections||This section demonstrates all requests related to tracking plan configurations for a given source, such as, creating/updating, fetching, connecting, listing or deleting/removing source-tracking plan connections.|
Refer to the Tracking Plan API documentation in Postman for detailed information on the API methods.
Questions? Contact us by email or on