4.1 API Keys & List ID

ReactIn’s API requires a valid API key and a list ID (also called SmartList ID) to authenticate and route your requests.

Written By Theo Remola

Last updated 11 months ago

To use the ReactIn API (whether to add leads or extract enriched data), you need:

  1. A SmartList of type ReactIn API

  2. The API code snippet auto-generated by ReactIn

  3. Your organization ID and the associated list ID


🔑 How to get your API key (no need to request it)

ReactIn automatically generates your API key when you create a special SmartList.

✅ Steps:

  1. Go to your ReactIn dashboard

  2. Create a new SmartList

  3. In the list type dropdown, select “ReactIn API”

  4. Once the list is created, a code block will appear — it includes:

    • Your API key (already injected in the Authorization header)

    • The correct endpoint, including your organizationId and listId

⚠️ Treat this key as a secret. Never expose it in frontend code or public repos.


📋 How to get your Organization ID & List ID

Each organization has a unique ID. You can get it the same way you did for the API Key:

There are two ways to retrieve your listId:

  • It’s embedded directly in the URL of your SmartList:

    https://app.reactin.io/[OrganizationName]/lists/[listId]
  • It also appears in the endpoint URL provided in the code snippet when you create the ReactIn API list:

You’ll need this listId to push or extract leads via the API.


✅ Your API is ready to use

As soon as your ReactIn API SmartList is created, you’re ready to:

  • Push leads to that list via POST

  • Extract enriched leads from it via GET

No manual setup, no API key request needed.


💡 Pro tip: Securely store your API key and regularly rotate it—this keeps your integration safe and reliable.

Ready to move on?
👉 Next Step: Add Leads via API →