# Peach ## Docs - medias [About uploaded media](https://developers.trypeach.ai/about-uploaded-media-1792183m0.md): - webhooks [Order status webhooks](https://developers.trypeach.ai/order-status-webhooks-1037980m0.md): - webhooks [Flow execution status webhooks](https://developers.trypeach.ai/flow-execution-status-webhooks-1042342m0.md): - webhooks [Message delivery status webhooks](https://developers.trypeach.ai/message-delivery-status-webhooks-1046655m0.md): - webhooks [AI Agent Execution Webhooks](https://developers.trypeach.ai/ai-agent-execution-webhooks-1048591m0.md): ## API Docs - template-messages [Send a pre-approved template message](https://developers.trypeach.ai/send-a-pre-approved-template-message-14208986e0.md): Send a template message to a contact. The WhatsApp template should be approved for this API to work. - template-messages [Poll template message status](https://developers.trypeach.ai/poll-template-message-status-17031228e0.md): Poll the status of the event used to send a template message to a contact. - template-messages [Poll template messages status](https://developers.trypeach.ai/poll-template-messages-status-17356547e0.md): Poll the delivery status of the template messages sent from the account, ordered by the last time they were updated. - template-messages [Connect to AI Agent](https://developers.trypeach.ai/connect-to-ai-agent-15933256e0.md): Connect to an AI Agent by sending a template message to a contact. The WhatsApp template should be approved for this API to work. - template-messages [Send an App message](https://developers.trypeach.ai/send-an-app-message-17800760e0.md): Send an App message to a contact. - broadcasts [List broadcasts](https://developers.trypeach.ai/list-broadcasts-31275901e0.md): List broadcast campaigns for the account. - broadcasts [Launch a broadcast](https://developers.trypeach.ai/launch-a-broadcast-24160344e0.md): Create and launch a WhatsApp broadcast to a list of contacts. The WhatsApp template to send should be approved for this API to work. - broadcasts [Poll broadcast status](https://developers.trypeach.ai/poll-broadcast-status-17031848e0.md): Poll the status of the event used to send a broadcast. - broadcasts [Get broadcast details](https://developers.trypeach.ai/get-broadcast-details-31523039e0.md): Fetch full details for a broadcast: template, audience, launch configuration, AI agent reply handler, and engagement stats. - broadcasts [Archive broadcast](https://developers.trypeach.ai/archive-broadcast-31523040e0.md): Archive a broadcast. Only possible when status is draft or active and no campaign runs are scheduled. - broadcasts [Cancel broadcast](https://developers.trypeach.ai/cancel-broadcast-31523041e0.md): Cancel all pending/scheduled runs of a broadcast. Use this when a broadcast was accidentally launched. Only affects runs that are still scheduled, queued, or queueing — already-sent messages are not recalled. - whatsapp_templates [List all templates](https://developers.trypeach.ai/list-all-templates-17823616e0.md): - whatsapp_templates [Create a template](https://developers.trypeach.ai/create-a-template-17826415e0.md): - whatsapp_templates [Update template](https://developers.trypeach.ai/update-template-17827088e0.md): - whatsapp_templates [Archive template](https://developers.trypeach.ai/archive-template-17827100e0.md): - whatsapp_templates [Pause template](https://developers.trypeach.ai/pause-template-17827257e0.md): - whatsapp_templates [Submit template](https://developers.trypeach.ai/submit-template-17827282e0.md): - whatsapp_templates [Fetch template details](https://developers.trypeach.ai/fetch-template-details-27759413e0.md): - conversations [List messages](https://developers.trypeach.ai/list-messages-27759211e0.md): List all messages for the account. Supports filtering by direction, date, and business phone number. - conversations [List conversations](https://developers.trypeach.ai/list-conversations-31275899e0.md): List conversations for the account. Supports filtering by status, escalation, activity type, and time windows. - conversations [Update conversation status](https://developers.trypeach.ai/update-conversation-status-31275900e0.md): Update the status of a conversation. Use this to close, reopen, or set a conversation to pending. - conversations [Agent Assignment](https://developers.trypeach.ai/agent-assignment-17799961e0.md): - conversations [Close Conversation](https://developers.trypeach.ai/close-conversation-17799998e0.md): - conversations [Unassign Agent](https://developers.trypeach.ai/unassign-agent-39536508e0.md): - contacts [Create multiple contacts](https://developers.trypeach.ai/create-multiple-contacts-18717155e0.md): Create a contact - contacts [Update a contact](https://developers.trypeach.ai/update-a-contact-24616411e0.md): - contacts [Create a contact](https://developers.trypeach.ai/create-a-contact-14208987e0.md): Create a contact - contacts [Bulk update communication preferences](https://developers.trypeach.ai/bulk-update-communication-preferences-33711627e0.md): Update communication_preference for multiple contacts in one request. Capped at 1000 phone numbers per request and 30 requests per 60-second window per account. - contacts [Create setup guest link](https://developers.trypeach.ai/create-setup-guest-link-37104468e0.md): Create a guest setup link for onboarding. - contacts [Expire setup guest link](https://developers.trypeach.ai/expire-setup-guest-link-37104469e0.md): Expire a setup guest link by id. - contacts [Regenerate setup guest link](https://developers.trypeach.ai/regenerate-setup-guest-link-37104470e0.md): Regenerate a setup guest link by id. - orders [Create an order](https://developers.trypeach.ai/create-an-order-14208988e0.md): Create a new order for collecting payments from your customer on WhatsApp - orders [Find order by ID](https://developers.trypeach.ai/find-order-by-id-14208989e0.md): Fetch details of an order - orders [Create a refund for an order](https://developers.trypeach.ai/create-a-refund-for-an-order-14208990e0.md): Issue a full or partial refund for an order via WhatsApp Payment - medias [List available medias](https://developers.trypeach.ai/list-available-medias-16593970e0.md): - medias [Add a media (Deprecated)](https://developers.trypeach.ai/add-a-media-deprecated-16594170e0.md): Deprecated: use the direct-upload flow (`POST /api/v1/medias/direct_uploads`, upload to storage, then `POST /api/v1/medias/finalize`). - medias [Remove a media](https://developers.trypeach.ai/remove-a-media-16594274e0.md): - medias [Create a direct upload for media](https://developers.trypeach.ai/create-a-direct-upload-for-media-33851048e0.md): Preferred upload flow for new integrations. Step 1: create a direct upload target. Step 2: upload the raw file bytes to the returned `direct_upload.url` using the returned `direct_upload.headers`. Step 3: call `/api/v1/medias/finalize` with the returned `signed_id`. - medias [Finalize a direct uploaded media](https://developers.trypeach.ai/finalize-a-direct-uploaded-media-33851049e0.md): Attach a direct-uploaded blob into the media library and return a media:// reference. - streams [List automations](https://developers.trypeach.ai/list-automations-37104471e0.md): List Stream automations for the account. - streams [Create automation](https://developers.trypeach.ai/create-automation-37104472e0.md): Create a Stream automation. execution_mode defaults to definition_driven when a definition is present. Publishing validates the definition. - streams [Get automation](https://developers.trypeach.ai/get-automation-37104473e0.md): Fetch a single automation including its step-graph definition. - streams [Update automation](https://developers.trypeach.ai/update-automation-37104474e0.md): Update name/description/status/definition. Set status=published to publish. - streams [Trigger automation](https://developers.trypeach.ai/trigger-automation-37104475e0.md): Fire an event at an automation for a contact. The payload (with a trigger's data-mappings) becomes {{key}} in steps. - triggers [List triggers](https://developers.trypeach.ai/list-triggers-37104476e0.md): List the triggers configured on an automation. - triggers [Create trigger](https://developers.trypeach.ai/create-trigger-37104477e0.md): Configure a trigger so the automation runs when an event arrives. Pick an expression_id (the WHEN) from GET /api/v1/expressions and supply its variables. data_mappings pull payload fields via JSONPath: recipient = who to message; variable = {{key}} in steps. The event source is derived from the expression automatically. Triggers start as draft; activate:true goes live (registers webhooks). - triggers [Update trigger](https://developers.trypeach.ai/update-trigger-37104478e0.md): Update variables, data_mappings (replaces all), description, or activation. activate:true activates (registers webhooks); false pauses. - expressions [List condition library](https://developers.trypeach.ai/list-condition-library-37104479e0.md): The reusable trigger conditions you reference when creating a trigger. Each has a topic/description and the variables you must supply. ## Schemas - Schemas [WhatsApp Template](https://developers.trypeach.ai/whatsapp-template-12763783d0.md): - Schemas [WhatsApp Template Parameters](https://developers.trypeach.ai/whatsapp-template-parameters-12763784d0.md): - Schemas [Order](https://developers.trypeach.ai/order-5384645d0.md): - Schemas [RefundRequest](https://developers.trypeach.ai/refundrequest-5384646d0.md): - Schemas [Contact](https://developers.trypeach.ai/contact-5384647d0.md): - Schemas [LineItem](https://developers.trypeach.ai/lineitem-5384648d0.md): - Schemas [OrderExpiry](https://developers.trypeach.ai/orderexpiry-5384649d0.md): - Schemas [TemplateMessage](https://developers.trypeach.ai/templatemessage-5384650d0.md): - Schemas [AnyValue](https://developers.trypeach.ai/anyvalue-5384651d0.md): - Schemas [Argument](https://developers.trypeach.ai/argument-5384652d0.md): - Schemas [Message](https://developers.trypeach.ai/message-12778456d0.md): - Schemas [MessageResponse](https://developers.trypeach.ai/messageresponse-12778457d0.md):