The Visage Public API lets your tools talk to Visage automatically. Instead of manually checking for new candidates or copying data between systems, the API keeps everything in sync, so your team can focus on hiring, not data entry.
What can you do with it?
Push candidates into your ATS. When Visage finds a promising candidate, their profile and resume flow directly into your Applicant Tracking System.
Sync jobs from your internal tools. Create and update Visage jobs from your HRIS, ATS or internal systems, so you never have to manage job postings in two places.
Build custom dashboards. Pull sourcing data into your BI tools to track performance alongside your other recruiting metrics.
Trigger automations. Connect Visage to Zapier, Make, or n8n. Get a Teams notification when a new candidate is ready, create a task for the hiring manager, or kick off any workflow you need.
How does it work?
The API works in two directions:
You pull from Visage. Your systems can request candidate data, job details, or resume files whenever they need them.
Visage pushes to you (webhooks). Visage sends a real-time notification to a URL you choose the moment something happens (e.g., a new candidate is marked as interested). No need to keep checking. Visage tells you.
Setting It Up
This section is for whoever will handle the technical setup: a developer, your ops team, or an integration platform like Zapier.
The full technical documentation can be found here: https://public-api.visage.jobs/docs
Configuring the public API is done through the application. Go to Settings > Visage API.
Generate an API Key
API keys authenticate all requests. Only account administrators can create them.
Go to Settings > Visage API in the Visage app
Click Create API Key
Give the key a label (optional)
Copy the key immediately. It is only shown once.
Store the key securely (e.g., in a secrets manager or environment variable).
Managing keys. From the Settings > Visage API page you can view all active/revoked keys, see when each was last used, and revoke any key instantly. We recommend creating a separate key per integration so you can revoke one without disrupting the others.
Set Up Webhooks
Webhooks let Visage push candidate data to your systems the moment it's available.
Go to Settings > Visage API
Enter the URL where you want to receive notifications
Visage sends a validation request to confirm your URL is reachable
Once validated, the webhook is active
Your endpoint must accept HTTPS POST requests and respond with a 2xx status code.
What's in the payload? The full candidate profile: name, email, LinkedIn URL, experience, education, and more, delivered as JSON. See the API documentation for the complete schema.
Security. You can configure a client secret to verify that incoming requests genuinely come from Visage via a signature header. Details and code examples are in the API docs.
Logs & testing. Visage keeps a log of all webhook deliveries (viewable in Settings > Visage API) and lets you send a test webhook event to verify your endpoint before going live.
Need Help?
Reach out to your Visage account manager or contact our tech team at tech@visage.jobs.