curl --request GET \
--url 'https://api.peoplewisher.com/v1/celebration-groups' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"success": true,
"data": [
{
"group_id": 24,
"name": "Customers",
"category": "birthday",
"status": "active",
"date_created": "2026-09-28 16:00:00",
"data_source_id": null,
"data_source_name": null,
"data_source_type": null,
"contact_count": 174
},
{
"group_id": 25,
"name": "Work Anniversaries",
"category": "work_anniversary",
"status": "active",
"date_created": "2026-09-28 16:02:00",
"data_source_id": null,
"data_source_name": null,
"data_source_type": null,
"contact_count": 42
}
]
}
API Reference
List Celebration Groups
List the Celebration Groups available to your Peoplewisher account. Each group includes its celebration category so your application can determine where a contact belongs.
GET
/
celebration-groups
curl --request GET \
--url 'https://api.peoplewisher.com/v1/celebration-groups' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"success": true,
"data": [
{
"group_id": 24,
"name": "Customers",
"category": "birthday",
"status": "active",
"date_created": "2026-09-28 16:00:00",
"data_source_id": null,
"data_source_name": null,
"data_source_type": null,
"contact_count": 174
},
{
"group_id": 25,
"name": "Work Anniversaries",
"category": "work_anniversary",
"status": "active",
"date_created": "2026-09-28 16:02:00",
"data_source_id": null,
"data_source_name": null,
"data_source_type": null,
"contact_count": 42
}
]
}
curl --request GET \
--url 'https://api.peoplewisher.com/v1/celebration-groups' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"success": true,
"data": [
{
"group_id": 24,
"name": "Customers",
"category": "birthday",
"status": "active",
"date_created": "2026-09-28 16:00:00",
"data_source_id": null,
"data_source_name": null,
"data_source_type": null,
"contact_count": 174
},
{
"group_id": 25,
"name": "Work Anniversaries",
"category": "work_anniversary",
"status": "active",
"date_created": "2026-09-28 16:02:00",
"data_source_id": null,
"data_source_name": null,
"data_source_type": null,
"contact_count": 42
}
]
}
How it works
Celebration categories
Peoplewisher currently supports these celebration categories:birthdayanniversarywork_anniversarywedding_anniversary
Authentication
Include your Peoplewisher API key as a Bearer token on every request:Authorization: Bearer YOUR_API_KEY
