API Access

Your API key

Cool Popup provides a REST API for programmatic access to your account. To use it, you need an API key.

Navigate to Account → API to view your current API key.

Managing your key

• Copy — Click the copy button to copy the key to your clipboard
• Regenerate — Click Regenerate to create a new key and invalidate the old one

Using the API

All API requests require the key in the Authorization header:

curl -X GET "https://dash.coolpopup.com/api/campaigns" \
  -H "Authorization: Bearer YOUR_API_KEY"

Full API documentation

The complete API reference — including all endpoints, parameters, and response formats for campaigns, notifications, notification handlers, domains, teams, and more — is available directly in your dashboard at:

dash.coolpopup.com/api-documentation

The interactive documentation includes:

• User — Read your account details
• Campaigns — List, create, update, and delete campaigns
• Notifications — Full CRUD for notification widgets with all type-specific settings
• Notification Handlers — Manage delivery destinations (email, webhook, Slack, etc.)
• Domains — Add and manage custom domains
• Teams — Create teams and manage members with granular permissions
• Team Members — Invite, update permissions, and remove members
• Payments — Read-only access to payment history
• Logs — Read-only access to activity logs