How it works
Cernel provides two developer capabilities under Settings > Developer:- API lets you authenticate requests to the Public API using a unique token tied to your organization.
- Webhooks send HTTP POST notifications to your endpoints whenever key events happen in Cernel.
Why you would use this
Automate product syncing
Push products from your ERP, PIM, or custom backend into Cernel without manual imports.
React to enrichment in real time
Get notified the moment AI-generated content is ready, so your systems can pull and publish it automatically.
Step-by-step guide
Managing your API token
Open API settings
Go to Settings > API. You’ll see your API token (masked by default), the last refresh date, and a link to the API documentation.
Copy your token
Click the copy icon next to the token field to copy it to your clipboard. Click Show to reveal the full token if you need to verify it.
Refresh your token (if needed)
Click New key to generate a new token. A confirmation dialog will warn you that the current token will stop working immediately.
Configuring webhooks
Open webhook settings
Go to Settings > Webhooks. You’ll see three webhook types, each with a URL field and a test button.
Enter your endpoint URL
For each webhook you want to enable, enter the URL where Cernel should send POST requests. The URL must start with
http:// or https://.Webhook event types
Cernel supports three webhook events:| Event | When it fires | Use case |
|---|---|---|
| Attribute Result | An AI-generated attribute value is ready for a product | Trigger downstream processing as soon as content is generated |
| Product Updated | A product is updated with enriched content | Sync updated product data to your store or PIM |
| Product Created | A new product is created in Cernel | Keep external systems in sync when products arrive |
Advanced configuration
Using webhooks with the API pipeline
Using webhooks with the API pipeline
Webhooks pair naturally with the Public API integration. Push products in via API, let automations enrich them, then receive webhook notifications when results are ready. See Building a custom product pipeline for a full walkthrough.
Webhook reliability
Webhook reliability
If your endpoint returns an error or is unreachable, the webhook delivery will fail. Cernel does not currently retry failed deliveries. Make sure your endpoint is available and returns a 2xx status code.
Security considerations
Security considerations
Webhook URLs are stored in your organization settings. Only admin users can view or modify them. Keep your webhook endpoints secured with authentication on your end to prevent unauthorized requests.
Frequently asked questions
Where do I find my API token?
Where do I find my API token?
Go to Settings > API. Your token is displayed there (masked by default). Click Show to reveal the full value, or click the copy icon to copy it.
Can I have multiple API tokens?
Can I have multiple API tokens?
No. Each organization has one API token at a time. Refreshing generates a new token and invalidates the previous one.
Why isn't my webhook receiving events?
Why isn't my webhook receiving events?
Check that your URL is correct and reachable. Use the Test Webhook button to verify. Make sure your endpoint returns a 2xx status code. If the test succeeds but live events don’t arrive, confirm that the relevant actions (enrichment, product creation) are actually happening.
Can I configure webhooks for other events?
Can I configure webhooks for other events?
Currently, Cernel supports three webhook events: Attribute Result, Product Updated, and Product Created. More event types may be added in future updates.
What’s next
Public API
Set up a full API integration for pushing products programmatically.
Automations
Auto-enrich products pushed via API with automations.