--- title: Flodesk API Integration on Truto slug: flodesk category: Marketing Automation canonical: "https://truto.one/integrations/detail/flodesk/" --- # Flodesk API Integration on Truto **Category:** Marketing Automation **Status:** Generally available ## Unified APIs ### Unified Marketing Automation API - **Contacts** — The contact represent a contact in the remote system. - **Segments** — Represents a segment of contacts in the remote system. ## MCP-ready AI tools Truto exposes 18 tools for Flodesk that AI agents can call directly. - **list_all_flodesk_segments** — List all segments in Flodesk. Returns id, name, total_active_subscribers, created_at, and color for each segment. - **get_single_flodesk_segment_by_id** — Get details of a specific segment in Flodesk using id. Returns id, name, total_active_subscribers, created_at, and color fields in the response. - **create_a_flodesk_segment** — Create a segment in Flodesk. Requires name and color. Returns id, name, total_active_subscribers, created_at, and color in the response. - **list_all_flodesk_subscribers** — List all subscribers in Flodesk. Returns each subscriber's id, status, email, first_name, last_name, segments, custom_fields, optin_ip, optin_timestamp, and created_at. - **get_single_flodesk_subscriber_by_id** — Get a specific subscriber in Flodesk using id_or_email. Returns id, status, email, source, name fields, segments, custom_fields, optin_ip, optin_timestamp, and created_at. - **create_a_flodesk_subscriber** — Create or update a subscriber in Flodesk using email or id. Returns subscriber details including id, status, email, source, first_name, last_name, segments, custom_fields, optin_ip, optin_timestamp, and created_at. - **delete_a_flodesk_subscriber_by_id** — Remove a subscriber from segments in Flodesk. Requires id_or_email and segment_ids. Returns subscriber details including id, status, email, segments, and custom_fields. - **list_all_flodesk_segment_colors** — List all available segment colors in Flodesk. Returns an array of color strings representing the available segment color options. - **list_all_flodesk_workflows** — List workflows in Flodesk. Returns an array of workflows with fields id and name for each workflow. - **create_a_flodesk_workflow** — Add a subscriber to a workflow in Flodesk. Requires id for the workflow and either subscriber id or email. Subscribers must not be active or in abandoned cart workflows. Returns subscriber details and workflow status. - **delete_a_flodesk_workflow_by_id** — Remove a subscriber from a specific workflow in Flodesk. Requires workflow_id and id. Returns 204 on success or 404 if not found. - **list_all_flodesk_custom_fields** — List all custom fields in Flodesk. Returns key and label for each field. - **create_a_flodesk_custom_field** — Create a custom field in Flodesk using the required parameter label. Returns details of the created custom field, including its id, label, and metadata. - **list_all_flodesk_webhooks** — List all webhooks in Flodesk. Returns webhook details including id, event type, target URL, and creation timestamp. - **get_single_flodesk_webhook_by_id** — Get details of a specific webhook in Flodesk using id. Returns webhook configuration fields including the event type, target URL, and status. - **create_a_flodesk_webhook** — Create a webhook in Flodesk. Requires name, post_url, and events. Returns id, post_url, events, and created_at fields in the response. - **update_a_flodesk_webhook_by_id** — Update a webhook in Flodesk using id. Returns id, post_url, events, and created_at fields describing the updated webhook configuration. - **delete_a_flodesk_webhook_by_id** — Delete a webhook in Flodesk using id. Returns 204 on successful deletion or 404 if the specified webhook is not found. ## How it works 1. **Link your customer's Flodesk account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Flodesk.** The Proxy API is a 1-to-1 mapping of the Flodesk API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync course enrollments to Flodesk for automated nurture sequences** — E-learning platforms can push student data into Flodesk as subscribers, assign them to course-specific segments, and enroll them in drip workflows — letting course creators run targeted email campaigns without leaving the LMS. - **Power post-purchase email flows for digital commerce platforms** — Storefronts selling digital products can sync buyer details and custom fields like purchase history into Flodesk, enabling creators to automate thank-you sequences, upsell campaigns, and segment VIP customers by lifetime value. - **Let event platforms trigger webinar reminder workflows in Flodesk** — Webinar and event hosting tools can register attendees as Flodesk subscribers and enroll them into pre-built reminder or follow-up workflows, giving hosts a seamless way to drive attendance and post-event engagement. - **Enable bidirectional audience sync for creative CRMs** — CRMs built for photographers, coaches, and freelancers can push leads into Flodesk for marketing while listening to Flodesk webhooks to capture unsubscribe events and update contact preferences back in the CRM in real time. - **Automate segment management from SaaS lifecycle events** — Any B2B SaaS can dynamically create and populate Flodesk segments based on user lifecycle stages — trial sign-up, activation, upgrade — so their customers can send perfectly targeted broadcasts without manual list management. ## What you can build - **One-click subscriber sync with upsert logic** — Automatically create or update Flodesk subscribers from your app's user events, using the subscriber upsert endpoint to avoid duplicates without pre-checking for existence. - **Dynamic segment builder from in-app events** — Programmatically create Flodesk segments and assign subscribers to them based on product activity like course completion, purchase tier, or subscription plan. - **Workflow enrollment and removal engine** — Enroll subscribers into Flodesk automation workflows when they hit key milestones, and remove them instantly when their status changes — for example, stopping trial nurture emails the moment a user converts to paid. - **Custom field passthrough for email personalization** — Create and populate Flodesk custom fields with SaaS-specific data like last login date, subscription tier, or purchase amount so end users can personalize every email they send. - **Real-time webhook listener for unsubscribe and engagement events** — Register Flodesk webhooks to capture subscriber events like unsubscribes and push that data back into your platform to keep contact preferences in sync. - **Unified contacts and segments management across marketing tools** — Use Truto's Unified Marketing Automation API to read and write contacts and segments across Flodesk and other marketing platforms through a single, normalized interface. ## FAQs ### What authentication method does the Flodesk integration use? Flodesk uses API key-based authentication. Your end users provide their Flodesk API key, and Truto handles storing and passing it securely on every request. ### Does the subscriber create endpoint handle duplicates? Yes. The create_a_flodesk_subscriber endpoint acts as an upsert — if a subscriber with the given email already exists, it updates their record instead of creating a duplicate. You don't need to check for existence beforehand. ### Can I create new automation workflows via the API? No. The create_a_flodesk_workflow endpoint adds a subscriber to an existing workflow — it does not create a new workflow from scratch. Workflows must be designed in the Flodesk UI first, then referenced by ID through the API. ### What Unified API models does Truto map Flodesk to? Flodesk is mapped to Truto's Unified Marketing Automation API, which provides normalized models for Contacts (subscribers) and Segments. This lets you integrate Flodesk alongside other marketing tools through a single schema. ### Can I pass custom data fields into Flodesk for email personalization? Yes. You can use list_all_flodesk_custom_fields to see existing fields and create_a_flodesk_custom_field to define new ones. These fields can then be populated on subscribers and used for personalization in Flodesk emails. ### How can I listen for changes happening inside Flodesk? Flodesk supports webhooks. You can use create_a_flodesk_webhook to register endpoints that receive real-time notifications for subscriber events like unsubscribes, and manage them with the update, list, get, and delete webhook endpoints.