Authentication

All API requests to the Popp AI API require authentication using both an API key and an Organization ID.

Getting Your Credentials

To obtain your API credentials, contact our support team at [email protected].

You will receive:

⚠️

Important: Your API key grants full access to your organization's data. Keep it secure and never expose it in client-side code.

Required Headers

Both credentials must be included in every API request:

Example Request

Include both headers with every request:

curl -X GET "https://api.popp.ai/v1/conversations" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-organization-id: YOUR_ORGANIZATION_ID" \
  -H "Content-Type: application/json"

Example with JavaScript

const response = await fetch('https://api.popp.ai/v1/conversations', {
  method: 'GET',
  headers: {
    'x-api-key': process.env.POPP_API_KEY,
    'x-organization-id': process.env.POPP_ORGANIZATION_ID,
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Next Steps

Now that you're authenticated, explore the API:

• Create a Conversation
• List Campaigns