API Documentation

salescloud Public API v1 — Full CRUD access to your CRM data. RESTful, JSON-based, paginated.

Base URL: https://salescloud.es JSON Bearer token auth

Authentication

All API requests require a Bearer token in the Authorization header. Generate API keys from your CRM dashboard under Settings > API Keys.

Authorization: Bearer YOUR_API_KEY
Permissions

Keys can have read, write and/or delete permissions.

Rate limits

100 requests/minute per API key. 429 on excess.

CORS

All endpoints return CORS headers. OPTIONS preflight supported.

Pagination

All list endpoints return paginated results with a meta object. The maximum limit is 100 items per page.

{
  "data": [ ... ],
  "meta": {
    "total": 150,
    "page": 1,
    "limit": 25,
    "pages": 6
  }
}

Error Handling

Errors return a JSON object with an error field and the appropriate HTTP status code.

StatusMeaning
400Bad request / validation error
401Invalid or missing API key
403Insufficient permissions on your API key
404Resource not found
429Rate limit exceeded
500Internal server error

Manage CRM contacts (people). Each contact can belong to a company.

Manage companies / organizations in your CRM.

Manage invoices. Supports VeriFactu e-invoicing format.

Manage sales leads before they become contacts or deals.

Manage deals / opportunities through your sales pipeline.

Manage tasks linked to projects, milestones and team members.

Need help integrating?

Contact us at hola@salescloud.es or check the OpenAPI spec.