CoPost Logo
API Triggers

Creating an Inbound API Trigger [POST]

Create an API trigger that can be hooked up to an external workflow such as Zapier, n8n, IFTTT, Pabbly and more.

Karl Fountain•
Smart Fallback Image
Smart Fallback Image

What is an Inbound trigger?

In CoPost, you can set up multiple unique inbound triggers that act as API endpoints. Each trigger can have a different purpose, for example one trigger can create draft posts while another can create and publish a post, each trigger can also have a different set of social platforms assigned to it.

A CoPost inbound trigger can be added to the end of any external workflow automation that is capable of sending a request to an API endpoint.

Types of Inbound trigger

There are a few types of trigger to choose from

  • Create a Draft
  • Publish a Draft
  • Create & Publish Post (Text Only)
  • Create & Publish Post (With Images)

How the trigger works

This endpoint uses the POST method and accepts a JSON payload. The JSON payload can contain the caption and an array of image URLs.

Each time the endpoint is triggered, a new post will be created containing the caption and images if any images were added to the JSON payload.

Setting up a 'Create & Publish Post (With Images)' trigger

  • Head over to the API Triggers area in CoPost.
Go to the API Triggers area
Go to the API Triggers area


  • Click on the Create New + button.
Click Create New
Click Create New


  • Choose Create & Publish Post (With Images) from the This trigger will dropdown.
Choose Create & Publish Post With Images from the dropdown
Choose Create & Publish Post With Images from the dropdown


  • Give your trigger a meaningful name and select the social platforms that each post will be posted to.
Name your trigger and select socials
Name your trigger and select socials


  • Copy or make a note of the URL and the JSON PAYLOAD information.
  • The URL is unique to this trigger so it is very important to use it exactly as shown here.
  • Make sure the JSON body uses this format (although images can be omitted if you just need a text only post to be created)
{
  "postText": "Your Caption here",
  "images": ["https://image1.jpg", "https://image2.jpg"],
}
Copy the URL and payload information provided
Copy the URL and payload information provided


  • Click Save to lock in your trigger.
Click Save
Click Save


  • You will now see the new trigger in the Inbound Triggers list
Your new trigger now shows in the list
Your new trigger now shows in the list


  • Now your trigger is ready to be used, head over to your external workflow
  • This is an example of a Content Creator agent that we use here at CoPost
  • Highlighted is the end part of the workflow (HTTP request) where we need to add the trigger information
Example n8n agent workflow
Example n8n agent workflow


This agent and others like it will soon be available to plug directly into your CoPost workflow with a user friendly set up directly in the CoPost app

  • In your HTTP request config, choose POST as the method and paste in the trigger URL
Choose POST and paste in the URL
Choose POST and paste in the URL


  • Add the postText value and the images array, although these will most likely be dynamic values as part of your automation, we're just showing hard typed values here for context.
Go to the API Triggers area
Go to the API Triggers area


And that is it, your new Inbound trigger is set up and ready to receive.

Thank you for reading. And as always, please send any questions to [email protected]. We are always here and happy to help!