GET
Listado de grupos de contactos
Scope:
contacts:contacts.readhttps://api.holded.com/api/v2/contact-groupsReturns 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
cursor
stringopcionalCursor opaco para paginación. Usa el valor devuelto en la respuesta anterior
limit
integeropcional= 50Nú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/jsonobject
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/json403Permisos insuficientesapplication/json429Límite de solicitudes excedidoapplication/json