Skip to Content

Account Management API

REST API v1 — Automate your data workflows, integrate with CI/CD pipelines, and build custom tooling with full programmatic access to your Vendo account.

Overview

The Vendo Account Management API provides complete programmatic access to manage your data integration workflows. Use it to:

  • Automate workflows — Trigger syncs, create integrations, and manage apps from scripts or pipelines
  • Build integrations — Connect Vendo to your internal tools, dashboards, or automation platforms
  • Enable AI agents — Allow AI assistants to manage your data infrastructure on your behalf
  • Power CLI tools — Build command-line interfaces for your team’s workflows

Base URL

All API requests should be made to:

https://app.vendodata.com/api/v1

Quick Example

# List all your apps
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://app.vendodata.com/api/v1/apps
 
# Trigger a source sync
curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://app.vendodata.com/api/v1/sources/{sourceId}/sync

Available Resources

ResourceDescription
AppsManage app connections (Shopify, Stripe, Google Ads, etc.)
SourcesConfigure data sources that import data into Vendo
DestinationsConfigure where data gets exported
IntegrationsSet up data flows between sources and destinations
ModelsManage Python data models for transformations
JobsMonitor and control sync jobs
CatalogBrowse available integration types

Response Format

All API responses follow a consistent JSON structure:

Success Response

{
  "data": {
    // Resource data or array of resources
  },
  "meta": {
    "pagination": {
      "total": 100,
      "limit": 20,
      "offset": 0,
      "hasMore": true
    }
  }
}

Error Response

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request body",
    "details": {
      "errors": [
        { "path": "name", "message": "Required field" }
      ]
    }
  }
}

Rate Limits

API requests are rate-limited per API key:

Limit TypeDefault
Requests per minute60
Requests per day10,000

Rate limit headers are included in all responses:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1709510400

Request ID

Every response includes a unique request ID for debugging:

X-Request-Id: req_1234567890_abc123

Include this ID when contacting support about specific API issues.

CLI

The Vendo CLI provides a terminal interface built on this API. Install it with:

npm install -g vendo-cli
vendo login

Next Steps

  • Authentication — Learn how to create and use API keys
  • CLI — Manage Vendo from the terminal
  • Apps — Start managing your app connections
  • Error Handling — Understand error codes and responses
Last updated on
Overview