Clientes

REST API — Todos los endpoints requieren autenticación mediante Bearer token. Incluye Authorization: Bearer {token} en cada solicitud. Los tokens se gestionan en Configuración de GitScrum → API. Base URL: https://services.gitscrum.com — Todas las rutas de solicitud en esta documentación son relativas a esta URL base.

Gestiona empresas clientes dentro de tu workspace. Crea, actualiza, lista y recupera detalles de clientes.

URL base: https://services.gitscrum.com

Todos los endpoints requieren el header Authorization: Bearer {token}.

Listar clientes

GET /contact-companies/clients?company_slug={slug}

Devuelve todos los clientes del workspace.

Respuesta

{
  "data": [
    {
      "uuid": "client-abc-123",
      "name": "Acme Corp",
      "email": "billing@acme.co",
      "phone": "+1-555-0100",
      "website": "https://acme.co",
      "address": "123 Main St, San Francisco, CA",
      "notes": "Enterprise client since 2024",
      "projects_count": 5,
      "invoices_total": 125000,
      "created_at": "2025-06-15T10:00:00Z"
    }
  ]
}

Obtener cliente

GET /contact-companies/{uuid}?company_slug={slug}

Devuelve los detalles completos del cliente.

Parámetros de ruta

Respuesta

{
  "data": {
    "uuid": "client-abc-123",
    "name": "Acme Corp",
    "email": "billing@acme.co",
    "phone": "+1-555-0100",
    "website": "https://acme.co",
    "address": "123 Main St, San Francisco, CA",
    "notes": "Enterprise client since 2024",
    "projects_count": 5,
    "invoices_total": 125000,
    "created_at": "2025-06-15T10:00:00Z"
  }
}

Crear cliente

POST /contact-companies

Crea un nuevo cliente en el workspace.

Cuerpo de la solicitud

Ejemplo

curl -X POST https://services.gitscrum.com/contact-companies \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "company_slug": "acme",
    "name": "Globex Corporation",
    "email": "contact@globex.com",
    "phone": "+1-555-0200",
    "website": "https://globex.com"
  }'

Respuesta

{
  "data": {
    "uuid": "client-def-456",
    "name": "Globex Corporation",
    "email": "contact@globex.com",
    "phone": "+1-555-0200",
    "website": "https://globex.com",
    "address": null,
    "notes": null,
    "projects_count": 0,
    "invoices_total": 0,
    "created_at": "2026-02-07T12:00:00Z"
  }
}

Actualizar cliente

PUT /contact-companies/{uuid}

Actualiza un cliente existente.

Parámetros de ruta

Cuerpo de la solicitud

Ejemplo

curl -X PUT https://services.gitscrum.com/contact-companies/client-def-456 \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "company_slug": "acme",
    "notes": "Renewed contract for 2026"
  }'

Referencia de campos