[{"data":1,"prerenderedAt":367},["ShallowReactive",2],{"docs-team-lead\u002Fintegrations\u002Fwebhooks-and-integrations":3},{"article":4,"sectionArticles":210,"categories":344,"relatedArticles":365,"prevArticle":248,"nextArticle":253,"categoryName":355,"error":366},{"id":5,"title":6,"avatar":7,"body":8,"description":202,"docx":7,"extension":203,"meta":204,"navigation":205,"order":7,"path":206,"pdf":7,"pdfLabel":7,"procurementPack":7,"seo":207,"slug":7,"stem":208,"__hash__":209},"content\u002Fdocs\u002Fteam-lead\u002Fintegrations\u002Fwebhooks-and-integrations.md","Webhooks and Integrations",null,{"type":9,"value":10,"toc":193},"minimark",[11,15,19,30,35,71,75,145,149,156,160,175,179],[12,13,6],"h1",{"id":14},"webhooks-and-integrations",[16,17,18],"p",{},"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.",[16,20,21,22,29],{},"For technical details on payload format, signature verification, and endpoint requirements, see the ",[23,24,28],"a",{"href":25,"rel":26},"https:\u002F\u002Fwww.headshotpro.com\u002Fapi",[27],"nofollow","API Documentation",".",[31,32,34],"h2",{"id":33},"how-it-works","How it works",[36,37,38,46,56,63],"ol",{},[39,40,41,42,29],"li",{},"Go to ",[43,44,45],"strong",{},"Admin > API Settings",[39,47,48,49,52,53,29],{},"Enter a publicly reachable HTTPS URL in the ",[43,50,51],{},"Webhook URL"," field and click ",[43,54,55],{},"Save",[39,57,58,59,62],{},"HeadshotPro generates a ",[43,60,61],{},"Webhook Secret"," used to sign every outgoing request. Copy and store it immediately.",[39,64,65,66,70],{},"Your URL receives a POST request whenever a supported event fires. Respond with any ",[67,68,69],"code",{},"2xx"," status to acknowledge receipt.",[31,72,74],{"id":73},"event-types","Event types",[76,77,78,91],"table",{},[79,80,81],"thead",{},[82,83,84,88],"tr",{},[85,86,87],"th",{},"Event",[85,89,90],{},"When it fires",[92,93,94,105,115,125,135],"tbody",{},[82,95,96,102],{},[97,98,99],"td",{},[67,100,101],{},"model.created",[97,103,104],{},"A new headshot session is created",[82,106,107,112],{},[97,108,109],{},[67,110,111],{},"model.status.updated",[97,113,114],{},"The session's status changes",[82,116,117,122],{},[97,118,119],{},[67,120,121],{},"model.photos_ready",[97,123,124],{},"Headshots are generated and ready to view",[82,126,127,132],{},[97,128,129],{},[67,130,131],{},"model.favorite_selected",[97,133,134],{},"A team member selects their favorite headshot",[82,136,137,142],{},[97,138,139],{},[67,140,141],{},"model.deleted",[97,143,144],{},"A session is deleted",[31,146,148],{"id":147},"zapier-integration","Zapier integration",[16,150,151,152,155],{},"HeadshotPro has a native Zapier app. From the API Settings page, click ",[43,153,154],{},"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.",[31,157,159],{"id":158},"good-to-know","Good to know",[161,162,163,166,169,172],"ul",{},[39,164,165],{},"Failed deliveries retry up to 4 times with escalating delays.",[39,167,168],{},"Only models belonging to your organization trigger webhooks.",[39,170,171],{},"Webhook settings require the API feature to be enabled. Contact support if the section is not visible.",[39,173,174],{},"Rotating the webhook secret immediately invalidates the old one — update your receiving endpoint first.",[31,176,178],{"id":177},"related","Related",[161,180,181,187],{},[39,182,183],{},[23,184,186],{"href":185},"\u002Fdocs\u002Fteam-lead\u002Fintegrations\u002Fapi-overview","API Overview",[39,188,189],{},[23,190,192],{"href":191},"\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Fmanaging-members","Member Management",{"title":194,"searchDepth":195,"depth":195,"links":196},"",2,[197,198,199,200,201],{"id":33,"depth":195,"text":34},{"id":73,"depth":195,"text":74},{"id":147,"depth":195,"text":148},{"id":158,"depth":195,"text":159},{"id":177,"depth":195,"text":178},"Connect HeadshotPro to your own systems or third-party tools using webhooks and Zapier.","md",{},true,"\u002Fdocs\u002Fteam-lead\u002Fintegrations\u002Fwebhooks-and-integrations",{"title":6,"description":202},"docs\u002Fteam-lead\u002Fintegrations\u002Fwebhooks-and-integrations","bLwuf4O8fA438uMtcgZ8KOs6ergzXfVG6QCJq8Zj5Vs",[211,217,222,227,233,238,243,248,252,253,259,264,269,273,278,283,288,293,298,304,309,314,319,324,329,334,339],{"title":212,"description":213,"path":214,"dir":215,"slug":216},"Billing History","How to view your organization's payment history, invoices, and credit activity log.","\u002Fdocs\u002Fteam-lead\u002Fbilling\u002Fbilling-history","\u002Fdocs\u002Fteam-lead\u002Fbilling","billing-history",{"title":218,"description":219,"path":220,"dir":215,"slug":221},"Credits Overview","How the credit system works for teams: what credits are, how they're consumed, and how to track usage.","\u002Fdocs\u002Fteam-lead\u002Fbilling\u002Fcredits-overview","credits-overview",{"title":223,"description":224,"path":225,"dir":215,"slug":226},"Purchasing Credits","How to buy additional credits for your team, including payment methods, volume pricing, and auto top-up.","\u002Fdocs\u002Fteam-lead\u002Fbilling\u002Fpurchasing-credits","purchasing-credits",{"title":228,"description":229,"path":230,"dir":231,"slug":232},"Creating a Team Account","Step-by-step guide to setting up a new HeadshotPro organization account.","\u002Fdocs\u002Fteam-lead\u002Fgetting-started\u002Fcreating-a-team","\u002Fdocs\u002Fteam-lead\u002Fgetting-started","creating-a-team",{"title":234,"description":235,"path":236,"dir":231,"slug":237},"Inviting Members","How to invite team members to your HeadshotPro organization — email invites, open invite links, and managed (on-behalf) adds.","\u002Fdocs\u002Fteam-lead\u002Fgetting-started\u002Finviting-members","inviting-members",{"title":239,"description":240,"path":241,"dir":231,"slug":242},"HeadshotPro for Teams: Overview","How HeadshotPro Teams works for organizations — consistency, management, and bulk ordering across your entire team.","\u002Fdocs\u002Fteam-lead\u002Fgetting-started\u002Foverview","overview",{"title":244,"description":245,"path":246,"dir":231,"slug":247},"Team Dashboard","Overview of the HeadshotPro admin dashboard — what you can monitor and manage from a single screen.","\u002Fdocs\u002Fteam-lead\u002Fgetting-started\u002Fteam-dashboard","team-dashboard",{"title":186,"description":249,"path":185,"dir":250,"slug":251},"A summary of the HeadshotPro API — what it does, what you can automate, and where to find the full documentation.","\u002Fdocs\u002Fteam-lead\u002Fintegrations","api-overview",{"title":6,"description":202,"path":206,"dir":250,"slug":14},{"title":254,"description":255,"path":256,"dir":257,"slug":258},"Creating and Managing Teams","How to create, edit, and delete sub-teams within your organization to group members by department","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Fcreating-teams","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team","creating-teams",{"title":260,"description":261,"path":262,"dir":257,"slug":263},"Custom Fields","Collect extra information from your team members during their headshot onboarding.","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Fcustom-fields","custom-fields",{"title":265,"description":266,"path":267,"dir":257,"slug":268},"Customizing Emails","Rewrite the subject, title, and body of the emails your team members receive from HeadshotPro.","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Fcustomizing-emails","customizing-emails",{"title":270,"description":271,"path":191,"dir":257,"slug":272},"Managing Members","View, search, filter, and navigate your organization's member list.","managing-members",{"title":274,"description":275,"path":276,"dir":257,"slug":277},"Organization Settings","Manage your organization's name, logo, contact details, and preferences.","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Forganization-settings","organization-settings",{"title":279,"description":280,"path":281,"dir":257,"slug":282},"Removing Members","Remove a member from your organization and understand what happens to their data.","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Fremoving-members","removing-members",{"title":284,"description":285,"path":286,"dir":257,"slug":287},"Roles and Permissions","Understand the three member roles and how to promote or demote users.","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Froles-and-permissions","roles-and-permissions",{"title":289,"description":290,"path":291,"dir":257,"slug":292},"Security Controls","Configure MFA enforcement, admin access, ownership, and data retention for your organization.","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Fsecurity-controls","security-controls",{"title":294,"description":295,"path":296,"dir":257,"slug":297},"SSO Setup","Connect your identity provider to HeadshotPro so team members authenticate through your company's existing SSO system.","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Fsso-setup","sso-setup",{"title":299,"description":300,"path":301,"dir":302,"slug":303},"Approving and Managing Headshots","How to review finished member headshots, mark them as handled, and download photos for the whole team","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fapproving-and-managing-headshots","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots","approving-and-managing-headshots",{"title":305,"description":306,"path":307,"dir":302,"slug":308},"Bulk Uploading Photos","Upload ZIP files for multiple team members at once to create headshot models without individual onboarding.","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fbulk-uploading-photos","bulk-uploading-photos",{"title":310,"description":311,"path":312,"dir":302,"slug":313},"Creating Profile Picture Templates","How to create branded profile picture templates with shape, background, border, outline, and logo overlay settings.","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fcreating-templates","creating-templates",{"title":315,"description":316,"path":317,"dir":302,"slug":318},"Enforcing Consistency","Use backdrop limits, combo configurations, and per-team overrides to keep all team headshots visually aligned.","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fenforcing-consistency","enforcing-consistency",{"title":320,"description":321,"path":322,"dir":302,"slug":323},"Issuing Retries","How to give a team member another attempt at generating their headshots","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fissuing-retries","issuing-retries",{"title":325,"description":326,"path":327,"dir":302,"slug":328},"Managing Profile Picture Templates","How to edit, delete, set a default, and apply profile picture templates to organization members.","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fmanaging-templates","managing-templates",{"title":330,"description":331,"path":332,"dir":302,"slug":333},"Pose Selection","Restrict which body poses HeadshotPro cycles through when generating headshots for your team.","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fpose-selection","pose-selection",{"title":335,"description":336,"path":337,"dir":302,"slug":338},"Style Presets","Choose the backdrops and outfits available to your team during headshot generation.","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fstyle-presets","style-presets",{"title":340,"description":341,"path":342,"dir":302,"slug":343},"Viewing Team Headshots","How to view and filter headshots across all members in your organization","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fviewing-team-headshots","viewing-team-headshots",[345,349,353,357,361],{"slug":346,"name":347,"articles":348},"billing","Billing",[211,217,222],{"slug":350,"name":351,"articles":352},"getting-started","Getting Started",[227,233,238,243],{"slug":354,"name":355,"articles":356},"integrations","Integrations",[248,252],{"slug":358,"name":359,"articles":360},"managing-your-team","Managing Your Team",[253,259,264,269,273,278,283,288,293],{"slug":362,"name":363,"articles":364},"team-headshots","Team Headshots",[298,304,309,314,319,324,329,334,339],[],false,1792738473912]