Getting started

Follow these steps to complete your first New Match API integration. Most teams ship a read-only job list in under an hour.

Register on newmatch.io

Create a company account on the website and verify your work email. Integrations are tied to that client profile—there is no separate integrator signup.

Request an API key

Tell us your company name and integration scenario via the developer contact form. Keys are created in Admin → API keys; the secret is shown once.

Set your base URL

All v1 integration endpoints live under your app origin:

URL

https://newmatch.io

Make your first request

List open jobs with your key—same examples in curl, fetch, or Python:

curl -X GET "https://newmatch.io/api/v1/jobs?status=open&limit=20" \
  -H "Authorization: Bearer <api-key>"

Production checklist

Store keys server-side only
Implement retries for 429/5xx with exponential backoff
Log response status and request IDs
Monitor integration health and alert on failures

Next steps

Try the playground or read how authentication and errors work.

Playground Authentication