OnePost
Use the OnePost API to quickly integrate your application with Twitter, Facebook, and Instagram. 1. Start by registering for the developer applications that you'll need for your application, such as Twitter and Facebook. 2. Then, use OnePost to allow your application's users to log in to each service through their web browser, thereby giving your application permission to post on their behalf.…
OnePost endpoints
| Method | Endpoint | Description |
|---|---|---|
| Providers | ||
| GET |
Get a Provider /api/v1/providers/{id} |
Get data for a single Provider record |
| GET |
Get All Providers /api/v1/providers |
Returns all Provider records owned by the API user account. |
| DELETE |
Delete a Provider /api/v1/providers/{id} |
Remove a Provider record from the system. **Warning:** This will immediately delete all data that belongs to this provider, such as Authorizations. |
| PUT |
Update a Provider /api/v1/providers/{id} |
Update a single Provider record owned by the API user |
| POST |
Create a Provider /api/v1/providers |
Create a new Provider record using data obtained by registering a developer application with a provider (such as Twitter or Facebook) |
| Authorizations | ||
| GET |
Get an Authorization /api/v1/authorizations/{id} |
Returns data for a single Authorization |
| GET |
Get All Authorizations /api/v1/authorizations |
Return all authorizations belonging to all Providers. |
| POST |
Create an Authorization /api/v1/authorizations |
Authorization creation must be done through a web browser. This endpoint provides a URL where you can create a new Authorization (along with some instructions). In a Production… |
| DELETE |
Delete an Authorization /api/v1/authorizations/{id} |
Immediately deletes an Authorization record. **WARNING:** This will remove all data belonging to the Authorization, such as SocialPost records. |
| Authorized Pages | ||
| GET |
Get an Authorized Page /api/v1/authorized_pages/{id} |
Gets data for a single AuthorizedPage record |
| GET |
Get All Authorized Pages /api/v1/authorized_pages |
Returns all AuthorizedPage records owned by the API user |
| Posts | ||
| GET |
Get All Posts /api/v1/posts |
Get all posts that have been created by the API user. |
| POST |
Publish a Post /api/v1/posts/{id}/publish |
Publish a post so that the content is sent to the social networks (specified by `authorized_page_ids`). The state of the post will transition from "draft" to "publishing" as each… |
| DELETE |
Delete a Post /api/v1/posts/{id} |
Immediately deletes a single Post in from the OnePost database. **Note:** This only deletes the post from OnePost. OnePost does not currently ever delete content from an… |
| GET |
Get a Post /api/v1/posts/{id} |
Fetch data for a single Post record owned by the API user |
| POST |
Create a Post /api/v1/posts |
Creates a new post in the "draft" state. After creating a new post, use the "publish" endpoint to send the post to each AuthorizedPage. [Upload an… |
| PUT |
Update a Post /api/v1/posts/{id} |
Use this endpoint to update a draft post owned by the API user. Once a post has been published, it can no longer be updated. |
| Post Intents | ||
| GET |
Get a Post Intent /api/v1/post_intents/{id} |
The [OnepostUI Javascript library](https://github.com/akdarrah/onepost-ui) will create Post Intent records rather than a Post directly. This is due to the fact that the UI… |
| Social Posts | ||
| GET |
Get All Social Posts /api/v1/social_posts |
Get all SocialPosts owned by the API user |
| GET |
Get a Social Post /api/v1/social_posts/{id} |
Get data for a single SocialPost owned by the API user |
| Webhooks | ||
| PUT |
Update a Webhook /api/v1/webhooks/{id} |
Update a webhook endpoint URL for a Webhook owned by the API user |
| POST |
Create a Webhook /api/v1/webhooks |
Creates a new Webhook for the API user. When an event is created within OnePost, we will attempt to send a POST request with event data for all Webhook endpoints that are… |
| GET |
Get a Webhook /api/v1/webhooks/{id} |
Return data for a single Webhook owned by the API user |
| DELETE |
Delete a Webhook /api/v1/webhooks/{id} |
Deletes a webhook owned by the API user |
| GET |
Get All Webhooks /api/v1/webhooks |
Return all data for webhooks owned by the API user |
| Events | ||
| GET |
Get All Events /api/v1/events |
Return all event data created on behalf of the API user |
| POST |
Create a Test Event /api/v1/events/test |
Creates a test event to test your webhook callback endpoint. When events are created, we will attempt to send the event to all Webhooks owned by the API user. |
| GET |
Get an Event /api/v1/events/{id} |
Return data for a single Event record owned by the API user |
| Images | ||
| GET |
Get All Images /api/v1/images |
List all images that have been uploaded. |
| GET |
Get an Image /api/v1/images/{id} |
Get data for a single Image record |
| POST |
Create an Image /api/v1/images |
Upload a new image to the image library, which can later be used as a pre-uploaded image option in [OnePost UI](https://github.com/akdarrah/onepost-ui) |
| DELETE |
Delete an Image /api/v1/images/{id} |
Remove an image record from the library of options |
| PUT |
Update an Image /api/v1/images/{id} |
Update the source field for an Image. |
OnePost pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $49 / month | — |
|