In Social Media Management, a "publishing" is considered a draft or scheduled post which has not yet been published. Once the post has been published, it will be considered a publication.

The Publishing API allows your third-party software tool to access information relating to the existing publishings in your Social Media Management organization. Using the Publishing API, you can access, edit, and delete publishings and add labels to them.

Publishing API endpoints

There are 12 endpoints available in the Publishing API:

• Schedule Draft
• Unschedule Draft
• Copy Draft
• Draft Status
• Delete Draft
• Get Labels
• Add Labels
• Remove Labels
• Create Draft
• Edit Draft
• Get Draft
• Get Locations (Facebook, Instagram, and X (Twitter))

Draft handling

Schedule Draft

Schedule an existing draft to be published at a future time. Using the schedule draft endpoint, you can specify the date, time, and timezone. Once scheduled, your post will be moved into the Scheduled section in Social Media Management.

Unschedule Draft

Using the Unschedule draft endpoint, you can remove the scheduled date and time for an existing scheduled post using the post ID. In Social Media Management, the post will be moved from Scheduled to Drafts.

Copy Draft

You can use the copy draft endpoint to copy the contents of an existing draft to create a new draft for different channels. You can choose to create the new draft for one channel, or several channels belonging to the same network (Facebook, X (Twitter), Instagram, or LinkedIn). You will need the existing Draft ID along with the Channel IDs for the new drafts.

Note:

You can locate your Channel IDs either from within Social Media Management or using the Channel API.

Draft Status

Using an existing Draft ID, find out if your draft is still in draft form (not yet scheduled or published), unapproved, scheduled, failed, or published.

Delete Draft

Delete a draft from the Social Media Management Calendar using the existing Draft ID.

Label handling

Get Labels

Using the Draft ID, retrieve a list of all labels which have been attached to the draft.

Add Labels

Add one or more labels to an existing draft. You will need the Draft ID and the applicable Label IDs.

Note:

You can retrieve your label IDs either from within Social Media Management or using the Labels API.

Remove Labels

Remove one or more labels from an existing draft. You will need the Draft ID and the applicable Label IDs.

Getting, creating, and editing drafts by network

The endpoints listed below allow you to create and manage drafts for each network. However, the information required may vary per network due to different draft requirements. Please visit the API Technical Documentation for the full list of requirements by network.

Create Draft

Using one or more Channel IDs, you can create a brand-new draft by adding content and media (text, image, video, or link content), scheduling a date and time if applicable, and otherwise customizing your post, for example by enabling URL shortening or specifying a Publisher for Instagram content.

Note:

Please take care to make sure that your new draft is in line with the post types supported by Social Media Management and the media guidelines for each network.

Edit Draft

Using a Draft ID, you can make changes to existing drafts, for example by changing the channel, schedule date and time, links, media, or location.

Get Draft

Using a Draft ID, you can find out all relevant information about an existing draft. Along with an in-depth overview of the contents, such as the text, media, links, promotion, and scheduled status, you can also find internal Social Media Management data, such as the creator, user notes, number of copies, and any labels.

Get Locations

Applicable only for Facebook, Instagram, and X (Twitter), you can use the get location endpoint to search for valid locations you can add to your posts. Searching by name along with a Channel ID, you can choose to limit your results to a certain number. Your results will include a Place or Location ID and a name.

Finding a Publishing ID

There are two ways you can locate the Publishing ID for any existing draft:

Via the Content API

Using the Get Channel Content endpoint of the Content API, you can retrieve information for all content by channel, including the ID. You can also limit your results based on scheduled status (e.g. draft, scheduled, unapproved, or published).

Via the Social Media Management

In Social Media Management, you can locate the ID of any draft by clicking on the draft to open it in Publish. The ID for your stock item will be visible in the last portion of the URL as shown below:

Benefits of the Publishing API

You may decide to use the Publishing API in conjunction with an Enterprise Resource Planning (ERP), Content Management System (CMS), or Data Access Management (DAM) tool to automatically generate posts based on specific triggers. For example, when new product visuals are uploaded or when a blog post is published. The integration can automatically generate a new draft and push it to Social Media Management.

Alternatively, you could create a spreadsheet with each row defining a new draft. Next, create and execute a custom macro to integrate the spreadsheet with Social Media Management via the Publishing API.

Accessing technical documentation

For general information about the features of our available APIs, check out our Introduction to APIs section. To view technical documentation for each Social Media Management API, please visit: falconio.docs.apiary.io.