# Adding Series to Sync
You can add a new series to Backtracks Proxy with the following call. This will start the process of synchronizing the series from the provided RSS feed URL. The duration of the initial synchronization will depend on how many episodes are in the feed and may take a while to complete. The feed will be monitored and automatically add new episodes to the series when they appear in the RSS feed.
# Add Series to Sync Request
TIP
To protect a private original or source feed URL from access by non-Backtracks systems, you may add Basic Auth to the feed URL and set the original_feed_url to a HTTPS Basic Auth URL similar to https://username:password@example.com/feed/123.rss.
POST https://api.backtracks.fm/v1/proxy HTTP/1.1
Accept: application/json
Authorization: JWT <your backtracks access token>...
Content-Type: application/json
{
"original_feed_url": "<rss feed url>"
}
# Additional Parameters
| Property | Type | Description |
|---|---|---|
| unified_prefix_key | string (128) | optional request payload parameter to set the universally unique unified_prefix_key |
TIP
The unified prefix key is a universally unique key (string) that is associated with a feed. The system will autogenerate a unique unified prefix key unless the API caller specifies a valid and unique unified prefix key. If the API caller specifies a unified prefix key that is invalid, already taken, or not unique then an error message and 400 series HTTP status code will be returned in the API response.
POST https://api.backtracks.fm/v1/proxy HTTP/1.1
Accept: application/json
Authorization: JWT <your backtracks access token>...
Content-Type: application/json
{
"original_feed_url": "<rss feed url>",
"unified_prefix_key": "<optional unified prefix key>",
}
# Add Series to Sync Response
HTTP/1.1 202 OK
Location: https://api.backtracks.fm/v1/proxy
Content-Type: application/hal+json; charset=utf-8
{
"status": "processing",
"_links": {
"self": {
"href": "https://api.backtracks.fm/v1/proxy"
}
}
}