Skip to main content
POST

How it works

Creating a group does not create or configure the messages sent to its members. Configure the group’s celebration settings, templates, channels, and workflow inside PeopleWisher.

Authentication

Include your Peoplewisher API key as a Bearer token on every request:
Your API key is available in Peoplewisher → Settings → API. Keep it private and never expose it in browser-side code or public repositories.

Authorizations

Authorization
string
header
required

Use the API key generated in Peoplewisher Settings as a Bearer token.

Body

application/json
name
string
required
category
enum<string>
required

Celebration category. Peoplewisher currently recognizes birthday, anniversary, work_anniversary, and wedding_anniversary.

Available options:
birthday,
anniversary,
work_anniversary,
wedding_anniversary

Response

Celebration Group created

success
boolean
data
object