Scope: contacts:contacts.write https://api.alladdin.com/api/v2/contact-groups

Creates a new contact group.
The response returns the new contact group id.

Request body

object name string required

Group name

description string optional

Group description

color string optional

Group color (hex code)

Request

import requests

url = "https://api.alladdin.com/api/v2/contact-groups"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "name": "string",
    "description": "string",
    "color": "string"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

Responses

Response

{
  "id": "507f1f77bcf86cd799439011"
}

Success responses

201 Contact group created application/json object id string

Error responses

400 Bad request application/json 401 Invalid or missing API key application/json 403 Insufficient permissions application/json 429 Rate limit exceeded application/json

Next →Update a contact group →