Prompt
When a new WordPress post is published, write a Facebook Page post with the title, a 2-sentence summary from the excerpt, and the link. Send it as a Facebook draft.How to do it
- Connect Facebook and mint a key In https://app.socialhandoff.com, open Connections, sign in with Facebook and pick the Pages to connect; each Page becomes its own channel. Then create an agent key named Zapier scoped to Facebook with draft permission.
- Set up the trigger Pick the trigger, for example New Post in WordPress, and map the title, excerpt, and URL into the post body.
- Import media by URL Add a Webhooks by Zapier Custom Request: POST https://app.socialhandoff.com/v1/media/import with JSON {"url": public https link, "alt": description} for photos (up to 10, each with alt text) or one video. No multipart needed. Keep the id it returns for the next step.
- Create the post Add a Webhooks by Zapier Custom Request: POST https://app.socialhandoff.com/v1/posts with a bearer header and JSON body {"body": text, "networks": ["facebook"], "mode": "submit"}, adding "mediaIds" only when photos were uploaded. The post lands in the approval inbox.
- Approve for the right Page The card shows which Page the post goes to. Approve on desktop or in the phone swipe stack, and it publishes to that Page at the scheduled time.
Example draft
New on the blog: How we cut our cloud bill by 40% without changing providers. We looked at every service we pay for, found the 3 that did most of the damage, and fixed them in a week. Here is exactly what we changed. https://example.com/blog/cloud-bill
Gotchas
- Only Facebook Pages can be connected, not personal profiles. Every Page you grant at sign-in becomes its own channel, so check which Page the card names before approving.
- Zapier may retry a failed step. Send an idempotencyKey built from the trigger record's id so a retry returns the same draft instead of a second one.
- A Page post can carry up to 10 photos or one video, not both. Each photo should have alt text, or the missing-alt-text guardrail flags it.
- Where you can post: Facebook Pages only. The API does not allow posting to personal profiles or to Groups through SocialHandoff.
- Page access: You need a role on the Page that allows creating content.
- Photos: One photo with alt text, or up to 10 photos in one post.
- Video: One video per post.
Frequently asked questions
Can one agent post to several Pages?
Yes. Every Page granted at sign-in connects as its own channel, and a key scoped to Facebook can draft for them. Each post names its Page on the approval card.
Is there a native Zapier app?
Not today. Webhooks by Zapier calls the REST API with a bearer header: one JSON request imports the media by URL, another creates the draft.
Why can only testers post at first?
Meta requires App Review and Business Verification before your own developer app can post for people outside its tester list. Until then, add people under App Roles.