Webhooks and Integrations
Connect HeadshotPro to your own systems or third-party tools using webhooks and Zapier.
Webhooks and Integrations
HeadshotPro sends real-time event notifications to a URL of your choice whenever something happens in your organization — a shoot is created, headshots are ready, a favorite is selected, and more. You can also connect to 5,000+ apps via the Zapier integration.
For technical details on payload format, signature verification, and endpoint requirements, see the API Documentation.
How it works
- Go to Admin > API Settings.
- Enter a publicly reachable HTTPS URL in the Webhook URL field and click Save.
- HeadshotPro generates a Webhook Secret used to sign every outgoing request. Copy and store it immediately.
- Your URL receives a POST request whenever a supported event fires. Respond with any
2xxstatus to acknowledge receipt.
Event types
| Event | When it fires |
|---|---|
model.created | A new headshot session is created |
model.status.updated | The session's status changes |
model.photos_ready | Headshots are generated and ready to view |
model.favorite_selected | A team member selects their favorite headshot |
model.deleted | A session is deleted |
Zapier integration
HeadshotPro has a native Zapier app. From the API Settings page, click Connect next to the Zapier card. Build Zaps that trigger on HeadshotPro events and connect to any of Zapier's 5,000+ supported apps — syncing new members from an HRIS, pushing finished headshots to Slack, logging shoots to a spreadsheet, and so on.
Good to know
- Failed deliveries retry up to 4 times with escalating delays.
- Only models belonging to your organization trigger webhooks.
- Webhook settings require the API feature to be enabled. Contact support if the section is not visible.
- Rotating the webhook secret immediately invalidates the old one — update your receiving endpoint first.