PipelimePipelime Docs

API Reference

Complete REST API documentation for Pipelime.

API Reference

The Pipelime API follows REST conventions and is documented using the OpenAPI 3.1 specification. All endpoints require authentication via API key or session.

Base URL

https://app.Pipelime.io/api

Authentication

Include your API key in the Authorization header:

curl -H "Authorization: Bearer ki_your_key_here" \
  https://app.Pipelime.io/api/campaigns

See Authentication for details on API keys, rate limits, and idempotency.

Endpoints

Campaigns

MethodPathDescription
GET/campaignsList campaigns
POST/campaignsCreate a campaign
GET/campaigns/{id}Get campaign details
PATCH/campaigns/{id}Update a campaign
DELETE/campaigns/{id}Delete a campaign
POST/campaigns/{id}/startActivate a campaign
POST/campaigns/{id}/pausePause a campaign

Contacts

MethodPathDescription
GET/contactsList contacts
POST/contactsCreate a contact
GET/contacts/{id}Get contact details
PATCH/contacts/{id}Update a contact
DELETE/contacts/{id}Delete a contact
POST/contacts/importImport contacts from CSV

Companies

MethodPathDescription
GET/companiesList companies
POST/companiesCreate a company
GET/companies/{id}Get company details
PATCH/companies/{id}Update a company

Email Accounts

MethodPathDescription
GET/email-accountsList email accounts
GET/email-accounts/{id}Get account details
PATCH/email-accounts/{id}Update account settings
DELETE/email-accounts/{id}Disconnect account

Blocklist

MethodPathDescription
GET/blocklistList blocklist entries
POST/blocklistAdd to blocklist
DELETE/blocklist/{id}Remove from blocklist

Webhooks

MethodPathDescription
GET/webhooksList webhooks
POST/webhooksCreate a webhook
DELETE/webhooks/{id}Delete a webhook
POST/webhooks/{id}/rotate-secretRotate webhook secret

API Keys

MethodPathDescription
GET/api-keysList API keys
POST/api-keysCreate an API key
DELETE/api-keys/{id}Revoke an API key

Activity

MethodPathDescription
GET/activityList activity events

Dashboard

MethodPathDescription
GET/dashboard/statsGet dashboard statistics

Interactive API Docs

For interactive API documentation with request/response schemas and a playground, visit the API Docs UI.

Error Format

All errors follow a consistent format:

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Campaign not found"
  }
}

Common Error Codes

CodeHTTP StatusDescription
UNAUTHORIZED401Missing or invalid authentication
FORBIDDEN403Insufficient permissions
NOT_FOUND404Resource not found
VALIDATION_ERROR422Invalid request body
RATE_LIMITED429Rate limit exceeded
INTERNAL_ERROR500Server error

On this page