What authentication does the Clearstream API use?

Clearstream uses API key authentication via the X-API-Key header. The key is generated in the Clearstream account settings. Through Jentic, the key is stored encrypted in your Jentic One instance and is never visible to the agent's prompt context.

Can I send MMS picture messages with the Clearstream API?

Yes. Upload the image through the media endpoint to obtain a media ID, then reference that ID in POST /messages alongside the target list. Clearstream delivers the image as an MMS to subscribers on supported carriers.

How do I bulk import subscribers from another system?

Use POST /subscribers/batch with an array of subscriber records. The endpoint upserts existing subscribers by phone number and creates new ones in the same call, which avoids hitting rate limits when syncing thousands of records.

What are the rate limits for the Clearstream API?

Rate limits are not declared in the public OpenAPI spec. For large operations such as subscriber sync use POST /subscribers/batch and POST /tags/{id}/subscribers rather than per-record calls so the server handles batching efficiently.

How do I segment and send through Jentic?

Search Jentic for 'apply a tag to subscribers and send broadcast'. Jentic returns the POST /tags/{id}/subscribers and POST /messages operations with their input schemas. Run pip install jentic, then await client.search, await client.load, await client.execute to chain the operations.

Can I limit what my agent is allowed to do with the Clearstream API?

Yes. Because you run Jentic One yourself, your own rules decide which Clearstream operations and credentials the agent may use. Clearstream puts the list id and tag id in the URL path, such as /lists/{id}/subscribers, so a rule can pin the agent to a single list and let it only add subscribers there. You choose the operations it can call, so broadcast sends via POST /messages stay out of reach unless you explicitly allow them.