Curator API: Create a Feed
POST https://api.curator.io/v1/feeds creates a feed in your Curator account. The request needs your API key, and your plan must include API access. Only HTTPS is supported.
Authentication
Send your Curator API key (find it in the Curator Dashboard) in one of three ways: as a query string (?api_key=API_KEY), as a Basic auth header with the API key as the username, or as a Bearer token (Authorization: Bearer API_KEY). The feed is created in the account the key belongs to.
Example request
curl -X POST "https://api.curator.io/v1/feeds?api_key=API_KEY" \
-d "name=Homepage feed"Parameters
Parameter | Description |
|---|---|
| Feed name, up to 200 characters. |
| The widget layout the feed starts with, such as |
| Status new posts get when they arrive: |
Response
A 200 response is the new feed object, described in Get Feeds. The new feed gets its own API ID and public key, and its caching settings come from your plan.
Errors
Status | When | Body |
|---|---|---|
401 | The API key is missing or not valid. |
|
403 | Your plan does not include API access. |
|
422 |
| A validation message with an |
429 | When rate limiting is enabled, more than 60 requests per minute. |
|