Developers

HappyNoodle API

A small, stable API for adding and reading contacts from your own tools. Available on paid plans.

1. Get an API key

In the app, go to Integrations → API keys and create a key. Choose read-only or read and write. The key is shown once; store it safely. You can revoke it at any time.

2. Send the key

Send it in the Authorization header on every request. Keys work only for the business that created them.

Authorization: Bearer YOUR_API_KEY

3. Contacts endpoint

List contacts

Newest first. Optional limit (default 50, maximum 200).

GET https://happynoodle.work/api/public/v1/contacts?limit=50

Create a contact (read and write keys only)

JSON body. All fields optional: first_name, last_name, email, phone, source, utm_source, utm_medium, utm_campaign, status (lead, client, past_client, archived).

POST https://happynoodle.work/api/public/v1/contacts
Content-Type: application/json

{ "first_name": "Sam", "email": "sam@example.co.uk", "source": "website" }

4. Limits and errors

  • 120 requests per minute per key. Over the limit returns 429 with a Retry-After header in seconds.
  • 401 missing or invalid key · 403 read-only key used to write · 400 invalid body.
  • Incoming webhooks (Integrations → Incoming links) are limited to 60 requests per minute per hook.