Skip to content
Back to Nouncify

Invitations

POST /v1/collections/{collection_id}/invites

Send invitation emails to multiple users at once.

FieldTypeRequiredDescription
usersarray✅Array of users to invite (max 100)
users[].emailstring✅Email address
users[].first_namestringFirst name (used in email greeting)
users[].last_namestringLast name
Terminal window
curl -X POST https://api.nouncify.com/v1/collections/{id}/invites \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"users": [
{"email": "priya@co.com", "first_name": "Priya"},
{"email": "james@co.com", "first_name": "James"}
]
}'

Response 201 Created

{
"total": 2,
"sent": 2,
"suppressed": 0,
"already_member": 0,
"invites": [
{"email": "priya@co.com", "status": "sent", "user_id": "..."},
{"email": "james@co.com", "status": "sent", "user_id": "..."}
]
}
GET /v1/collections/{collection_id}/invites
POST /v1/collections/{collection_id}/invites/{invite_id}/resend

When using a nfy_dev_ API key, invitation emails are sent, but any calls-to-action within the email will securely route the recipient to the sandbox recording environment (embed.sandbox.nouncify.com). This lets you test the complete end-to-end email delivery and recording flow without affecting your production directory.