Create a curation feed
const url = 'https://api.tryletterhead.com/api/v3/curations/feeds?api=true';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"title":"Example Daily","description":"Our syndication partner\'s RSS feed.","feedUrl":"https://example.com/rss","archiveIntervalDays":7,"crawl":true}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url 'https://api.tryletterhead.com/api/v3/curations/feeds?api=true' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "title": "Example Daily", "description": "Our syndication partner'\''s RSS feed.", "feedUrl": "https://example.com/rss", "archiveIntervalDays": 7, "crawl": true }'Create a company-level RSS feed, optionally shared across multiple channels. Letterhead crawls it
immediately after creation and then on the cadence implied by archiveIntervalDays.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters ”Required. Set to true to authenticate with your company API key rather than a signed-in session.
Request Body required
Section titled “Request Body required ”object
How often, in days, to re-crawl the feed (1–31).
Internal numeric channel identifiers to share this feed with.
Example
{ "title": "Example Daily", "description": "Our syndication partner's RSS feed.", "feedUrl": "https://example.com/rss", "archiveIntervalDays": 7, "crawl": true}Responses
Section titled “ Responses ”Feed created
object
The shape returned for both RSS feeds (List curation feeds) and JSON data feeds (List data
feeds) — type (0 RSS, 1 JSON data feed) tells the two apart. fieldMappings, authType,
and hasAuthSecret are only meaningful on a JSON data feed.
object
0 RSS feed, 1 JSON data feed.
The channel this feed was originally created against, or blank for a feed shared to multiple channels with no single owner.
Internal numeric identifiers of every channel this feed is shared with.
0 — no authentication. 1 — bearer token.
Whether a credential is stored — the credential itself is never returned.
object
Example generated
{ "items": { "uniqueId": "example", "title": "example", "description": "example", "feedUrl": "example", "type": 1, "isValid": true, "validationCode": 1, "crawl": true, "archiveIntervalDays": 1, "lastValidated": "example", "lastQueried": "example", "channelName": "example", "channelSlug": "example", "sharedChannelIds": [ 1 ], "tags": [ "example" ], "authType": 1, "hasAuthSecret": true, "fieldMappings": [ { "source": "example", "target": "example" } ], "createdAt": "example", "updatedAt": "example", "deletedAt": "example" }, "message": "example", "total": 1}Still can’t find what you need? Contact support.