Saltar al contenido principal
GET

Listado de grupos de contactos

Scope:contacts:contacts.read
https://api.holded.com/api/v2/contact-groups

Returns a paginated list of contact groups. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page.

Parámetros

Parámetros de consulta

cursorstringopcional

Cursor opaco para paginación. Usa el valor devuelto en la respuesta anterior

limitintegeropcional= 50

Número máximo de elementos a devolver

Petición

python
import requests

url = "https://api.holded.com/api/v2/contact-groups?cursor=value&limit=50"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Respuestas

Respuesta

json
{
  "items": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "string",
      "description": "string",
      "color": "string"
    }
  ],
  "cursor": "string",
  "has_more": false
}

Respuestas exitosas

200Listado de grupos de contactosapplication/json
object
items[]object[]required
idstringrequired

Unique identifier

namestringrequired

Group name

descriptionstringrequired

Group description

colorstringrequired

Group color

cursorstring | nulloptional
has_morebooleanrequired

Respuestas de error

401API key inválida o no proporcionadaapplication/json
403Permisos insuficientesapplication/json
429Límite de solicitudes excedidoapplication/json