Send deals in from your website

Steps

1. Mint a token in Developer › Your API tokens (if an admin has made you a developer) or Admin › API & agents. Pick Integration, tick intake.write, choose Expires after and click Mint token. The secret is shown once - store it in your server's secret manager.
2. Send the submission from your backend - never from a browser or an app build:

curl -X POST https://app.headwaystack.com/api/intake \
  -H "Authorization: Bearer hwa_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "source": "website-form",
        "company": { "name": "Harbour Clinic" },
        "contact": { "name": "Dana Voss", "email": "dana@harbourclinic.example" },
        "deal": { "name": "Harbour Clinic - enquiry" },
        "idempotencyKey": "form-1042" }'

1. Read the 201 - the created flags say what was new and what matched.
2. Retry with the same idempotencyKey - a replay returns the original result (replay: true), never a second deal.
3. Check Inbound - every submission lists there, newest first, with View submission and a link to the deal.