Your first request

Steps

1. Create an organization key

   In the app, open Settings › API keys, choose New key, name it after the integration that will use it, and give it only the permissions it needs. For this guide, leads:read is enough.

2. Keep it out of your code

   Store the key in an environment variable or your platform's secret store, never in source control:

   export LEADUP_API_KEY="lup_org_live_…"

3. Send it as a bearer token

   Every request carries the key in the Authorization header.

   cURLNode.jsPython

   curl "https://api.leadup.group/v1/leads?limit=5" \
     -H "Authorization: Bearer $LEADUP_API_KEY"

4. Read the page that comes back

   Lists return items and a nextCursor. Send the cursor back as cursor to read the next page; it is null on the last one.

   {
     "items": [
       {
         "id": "0192f0c1-7a3e-7c51-9d2e-4b7f0a1c2d3e",
         "companyName": "Clínica Sorriso Pleno",
         "segment": "dental",
         "city": "Campinas",
         "region": "SP",
         "stage": "proposal",
         "nextFollowUpAt": "2026-10-14T13:00:00Z"
       }
     ],
     "nextCursor": null
   }

If it fails

• 401 auth.unauthenticated: the key is missing, mistyped, revoked or expired. The API doesn't say which, on purpose.
• 403 auth.forbidden: the key works but lacks the permission this endpoint needs. Create a key with it.
• 429 request.rateLimited: wait for the seconds in Retry-After, then try again. See rate limits.

Next steps

• Find leads by stage, city or name.
• Move a lead through the pipeline.
• Browse every endpoint in the API reference.