Horneross - Automatización de Operaciones

GET

api

contacts

curl -X GET "https://app.horneross.com/api/contacts?limit=50&search=gmail" \
  -H "Authorization: Bearer sk_live_xxx"

const response = await fetch(
  'https://app.horneross.com/api/contacts?limit=50&search=gmail',
  {
    headers: {
      'Authorization': 'Bearer sk_live_xxx',
    },
  }
);

const { contacts, count } = await response.json();
console.log(`Total: ${count} contactos`);

import requests

response = requests.get(
    'https://app.horneross.com/api/contacts',
    headers={'Authorization': 'Bearer sk_live_xxx'},
    params={
        'limit': 50,
        'search': 'gmail'
    }
)

data = response.json()
print(f'Total: {data["count"]} contactos')

{
  "contacts": [
    {
      "id": "contact_abc123",
      "email": "maria@gmail.com",
      "phoneNumber": "+5491123456789",
      "firstName": "María",
      "lastName": "García",
      "instagramId": null,
      "organizationId": "org_xyz",
      "createdAt": "2024-01-21T10:00:00Z",
      "updatedAt": "2024-01-21T15:30:00Z"
    },
    {
      "id": "contact_def456",
      "email": "juan@gmail.com",
      "phoneNumber": null,
      "firstName": "Juan",
      "lastName": "Pérez",
      "instagramId": null,
      "organizationId": "org_xyz",
      "createdAt": "2024-01-20T14:00:00Z",
      "updatedAt": "2024-01-20T14:00:00Z"
    }
  ],
  "count": 150
}

Endpoint

GET /api/contacts

Obtené todos los contactos de tu organización con paginación y búsqueda.

Headers

Authorization

string

required

Bearer token con tu API key. Formato: Bearer sk_live_xxx

Query Parameters

offset

number

default:"0"

Número de página para paginación (0-indexed)

limit

number

default:"100"

Cantidad de resultados por página

string

Buscar contactos por email (búsqueda parcial)

curl -X GET "https://app.horneross.com/api/contacts?limit=50&search=gmail" \
  -H "Authorization: Bearer sk_live_xxx"

const response = await fetch(
  'https://app.horneross.com/api/contacts?limit=50&search=gmail',
  {
    headers: {
      'Authorization': 'Bearer sk_live_xxx',
    },
  }
);

const { contacts, count } = await response.json();
console.log(`Total: ${count} contactos`);

import requests

response = requests.get(
    'https://app.horneross.com/api/contacts',
    headers={'Authorization': 'Bearer sk_live_xxx'},
    params={
        'limit': 50,
        'search': 'gmail'
    }
)

data = response.json()
print(f'Total: {data["count"]} contactos')

Response

contacts

array

required

Array de contactos

Show Propiedades de cada contacto

contacts[].id

string

required

ID único del contacto

contacts[].email

string

Email del contacto

contacts[].phoneNumber

string

Número de teléfono (con código de país)

contacts[].firstName

string

Nombre del contacto

contacts[].lastName

string

Apellido del contacto

contacts[].instagramId

string

ID de Instagram (si fue capturado via Instagram)

contacts[].organizationId

string

required

ID de la organización

contacts[].createdAt

string

required

Fecha de creación (ISO 8601)

contacts[].updatedAt

string

required

Fecha de última actualización (ISO 8601)

count

number

required

Total de contactos que coinciden con los filtros (para paginación)

{
  "contacts": [
    {
      "id": "contact_abc123",
      "email": "maria@gmail.com",
      "phoneNumber": "+5491123456789",
      "firstName": "María",
      "lastName": "García",
      "instagramId": null,
      "organizationId": "org_xyz",
      "createdAt": "2024-01-21T10:00:00Z",
      "updatedAt": "2024-01-21T15:30:00Z"
    },
    {
      "id": "contact_def456",
      "email": "juan@gmail.com",
      "phoneNumber": null,
      "firstName": "Juan",
      "lastName": "Pérez",
      "instagramId": null,
      "organizationId": "org_xyz",
      "createdAt": "2024-01-20T14:00:00Z",
      "updatedAt": "2024-01-20T14:00:00Z"
    }
  ],
  "count": 150
}

Paginación

Para paginar resultados, usá offset y limit:

// Primera página
const page1 = await fetch('/api/contacts?offset=0&limit=50');

// Segunda página
const page2 = await fetch('/api/contacts?offset=1&limit=50');

// Tercera página
const page3 = await fetch('/api/contacts?offset=2&limit=50');

El offset representa el número de página (0-indexed), no el número de registros a saltar.

Crear contactoCrear un nuevo contacto manualmente.

curl -X GET "https://app.horneross.com/api/contacts?limit=50&search=gmail" \
  -H "Authorization: Bearer sk_live_xxx"

const response = await fetch(
  'https://app.horneross.com/api/contacts?limit=50&search=gmail',
  {
    headers: {
      'Authorization': 'Bearer sk_live_xxx',
    },
  }
);

const { contacts, count } = await response.json();
console.log(`Total: ${count} contactos`);

import requests

response = requests.get(
    'https://app.horneross.com/api/contacts',
    headers={'Authorization': 'Bearer sk_live_xxx'},
    params={
        'limit': 50,
        'search': 'gmail'
    }
)

data = response.json()
print(f'Total: {data["count"]} contactos')

{
  "contacts": [
    {
      "id": "contact_abc123",
      "email": "maria@gmail.com",
      "phoneNumber": "+5491123456789",
      "firstName": "María",
      "lastName": "García",
      "instagramId": null,
      "organizationId": "org_xyz",
      "createdAt": "2024-01-21T10:00:00Z",
      "updatedAt": "2024-01-21T15:30:00Z"
    },
    {
      "id": "contact_def456",
      "email": "juan@gmail.com",
      "phoneNumber": null,
      "firstName": "Juan",
      "lastName": "Pérez",
      "instagramId": null,
      "organizationId": "org_xyz",
      "createdAt": "2024-01-20T14:00:00Z",
      "updatedAt": "2024-01-20T14:00:00Z"
    }
  ],
  "count": 150
}

Empezar

Guías

Industrias

Developers

Soporte

Legal

Listar contactos

Endpoint

Headers

Query Parameters

Response

Paginación

​Endpoint

​Headers

​Query Parameters

​Response

​Paginación

Endpoint

Headers

Query Parameters

Response

Paginación