Paubox

Paubox Drip Campaigns API

Drip campaign management and automation operations

GitHub OpenAPI
Business capability
Digital Marketing Management BC-400.60

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /drip_campaigns List drip campaigns · Fetch drip campaigns #
Ask an LLM
“What drip campaigns do I have set up?”
“Can I search my drip campaigns by name?”
Tell an agent
List all my drip campaigns.
Find drip campaigns named like {search}.
GET /drip_campaigns/{id} Get details of one drip campaign · Fetch drip campaign #
Ask an LLM
“How do I see the configuration of a single drip campaign?”
“What details does a specific drip sequence have right now?”
Tell an agent
Show drip campaign {id}.
Get the details of drip sequence {id}.
PUT /drip_campaigns/{id} Update a drip campaign's settings · Update drip campaign #
Ask an LLM
“Can I change the settings of an existing drip campaign?”
“How do I rename or edit a drip sequence's attributes?”
Tell an agent
Update drip campaign {id} with {drip_campaign}.
Edit the attributes of drip sequence {id}.
POST /drip_campaigns/{id}/start Start a drip campaign · Start a drip campaign #
Ask an LLM
“How do I turn on a drip campaign so it begins sending?”
“Can I resume a paused drip sequence?”
Tell an agent
Start drip campaign {id}.
Activate drip sequence {id} so it starts sending.
POST /drip_campaigns/{id}/pause Pause a drip campaign · Pause a drip campaign #
Ask an LLM
“Is there a way to temporarily stop a drip campaign from sending?”
“How do I put a running drip sequence on hold?”
Tell an agent
Pause drip campaign {id}.
Put drip sequence {id} on hold.

Documentation

📖
Documentation
https://docs.paubox.com/email-api
📖
GettingStarted
https://docs.paubox.com/email-api/quickstart
📖
Authentication
https://docs.paubox.com/email-api/authentication
📖
Documentation
https://docs.paubox.com/marketing
📖
Documentation
https://docs.paubox.com/forms/index
📖
Authentication
https://docs.paubox.com/forms/authentication

Specifications

⚙
OpenAPI
https://artifacts.apis.io/paubox/openapi/paubox-drip-campaigns-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/paubox/json-schema/paubox-drip-campaigns-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/paubox/json-schema/paubox-update-drip-campaign-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/paubox/json-schema/paubox-pause-drip-campaign-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/paubox/json-schema/paubox-start-drip-campaign-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/paubox/json-schema/paubox-drip-campaign-response-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/paubox:paubox-drip-campaigns-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

paubox-drip-campaigns-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Paubox Marketing Drip Campaigns API
  description: 'Public documentation Paubox Marketing API.


    All Paubox Marketing customers have access to the Paubox Marketing API to automate various tasks.


    ## Authentication

    Use the authorization header in requests with the format: `authorization: Token token=`


    Replace `` with your API key. Find your API key in the address bar from the email builder (note: each API Key is displayed only once upon creation).


    ## Base URL

    `https://api.paubox.com/v1/marketing`'
  contact:
    name: Paubox Support
    url: https://www.paubox.com
  version: 1.0.0
servers:
- url: https://api.paubox.com/v1/marketing
  description: Production server
security:
- TokenAuth: []
tags:
- name: drip_campaigns
  description: Drip campaign management and automation operations
paths:
  /drip_campaigns:
    get:
      tags:
      - drip_campaigns
      summary: Fetch drip campaigns
      description: Return json data about Drip Campaigns
      operationId: getDripCampaigns
      parameters:
      - name: search
        in: query
        description: Regex string to search on. Compares against drip campaign name
        required: false
        schema:
          type: string
      - name: order_by
        in: query
        description: Attribute to sort on. Default value is created_at
        required: false
        schema:
          type: string
          default: created_at
      - name: order
        in: query
        description: Direction to sort. Default value is descending
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: desc
      responses:
        '200':
          description: Drip campaigns data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DripCampaignsResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /drip_campaigns/{id}:
    get:
      tags:
      - drip_campaigns
      summary: Fetch drip campaign
      description: Returns json data about a drip campaign
      operationId: getDripCampaign
      parameters:
      - name: id
        in: path
        description: The ID of the drip campaign to fetch
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Drip campaign data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DripCampaignResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
    put:
      tags:
      - drip_campaigns
      summary: Update drip campaign
      description: Updates drip campaign attributes
      operationId: updateDripCampaign
      parameters:
      - name: id
        in: path
        description: The ID of the drip campaign to update
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateDripCampaignRequest'
            example:
              drip_campaign:
                name: Welcome Series
                subscription_list_id: 123e4567-e89b-12d3-a456-426614174000
                start_trigger: subscription
                drip_campaign_nodes: '{"nodes": [], "edges": []}'
        required: true
      responses:
        '200':
          description: Drip campaign updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DripCampaignResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /drip_campaigns/{id}/start:
    post:
      tags:
      - drip_campaigns
      summary: Start a drip campaign
      description: Starts a drip campaign
      operationId: startDripCampaign
      parameters:
      - name: id
        in: path
        description: The ID of the drip campaign to start
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Drip campaign started successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StartDripCampaignResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /drip_campaigns/{id}/pause:
    post:
      tags:
      - drip_campaigns
      summary: Pause a drip campaign
      description: Pauses a drip campaign
      operationId: pauseDripCampaign
      parameters:
      - name: id
        in: path
        description: The ID of the drip campaign to pause
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Drip campaign paused successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PauseDripCampaignResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    StartDripCampaignResponse_data:
      type: object
      properties:
        jids:
          type: array
          description: Array of job IDs for the started drip campaign
          items:
            type: string
    StartDripCampaignResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/StartDripCampaignResponse_data'
    PauseDripCampaignResponse_data:
      type: object
      properties:
        drip_campaign_id:
          type: string
          description: ID of the paused drip campaign
        status:
          type: string
          description: Status of the drip campaign after pausing
    DripCampaignsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/DripCampaignsResponse_data'
    DripCampaignResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/DripCampaignResponse_data'
    DripCampaignResponse_data_attributes:
      type: object
      properties:
        name:
          type: string
          description: Name of the drip campaign
        subscription_list_id:
          type: string
          description: Subscription list ID
        subscription_list_name:
          type: string
          description: Name of the subscription list
        state:
          type: string
          description: Current state of the drip campaign
        updated_at:
          type: string
          description: Last update timestamp
          format: date-time
        start_trigger:
          type: string
          description: Trigger condition to start the drip campaign
        subscriber_count:
          type: integer
          description: Number of subscribers in the campaign
        subscriber_completed_count:
          type: integer
          description: Number of subscribers who completed the campaign
        drip_campaign_nodes:
          type: string
          description: JSON string containing drip campaign node configuration
        drip_campaign_tree_blob:
          type: string
          description: JSON string containing drip campaign tree structure
    DripCampaignsResponse_data:
      type: object
      properties:
        id:
          type: string
          description: Drip campaign ID
        type:
          type: string
          description: Resource type
          enum:
          - drip_campaign
        attributes:
          $ref: '#/components/schemas/DripCampaignsResponse_attributes'
    UpdateDripCampaignRequest_drip_campaign:
      type: object
      properties:
        name:
          type: string
          description: Name of the drip campaign
        subscription_list_id:
          type: string
          description: Subscription list ID
          format: uuid
        start_trigger:
          type: string
          description: Trigger condition to start the drip campaign
        drip_campaign_nodes:
          type: string
          description: JSON string containing drip campaign node configuration
    DripCampaignsResponse_attributes:
      type: object
      properties:
        name:
          type: string
          description: Name of the drip campaign
        subscription_list_id:
          type: string
          description: Subscription list ID
        subscription_list_name:
          type: string
          description: Name of the subscription list
        state:
          type: string
          description: Current state of the drip campaign
        updated_at:
          type: string
          description: Last update timestamp
          format: date-time
        start_trigger:
          type: string
          description: Trigger condition to start the drip campaign
        subscriber_count:
          type: integer
          description: Number of subscribers in the campaign
        subscriber_completed_count:
          type: integer
          description: Number of subscribers who completed the campaign
    UpdateDripCampaignRequest:
      type: object
      properties:
        drip_campaign:
          $ref: '#/components/schemas/UpdateDripCampaignRequest_drip_campaign'
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
        code:
          type: string
          description: Error code
        details:
          type: object
          description: Additional error details
    DripCampaignResponse_data:
      type: object
      properties:
        id:
          type: string
          description: Drip campaign ID
        type:
          type: string
          description: Resource type
          enum:
          - drip_campaign
        attributes:
          $ref: '#/components/schemas/DripCampaignResponse_data_attributes'
    PauseDripCampaignResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/PauseDripCampaignResponse_data'
  responses:
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    BadRequest:
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    UnprocessableEntity:
      description: Unprocessable entity
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    TokenAuth:
      type: apiKey
      description: 'Token-based authentication. Use format: "Token token=<API_KEY>" where <API_KEY> is your API key'
      name: authorization
      in: header