Introduction

The Nouncify Collections API lets you create and manage name pronunciation collections for your users. With a single API call, you can add users, send recording invitations, and retrieve play links — all without requiring your users to create a Nouncify account.

What you can build

• HR onboarding: Collect name pronunciations from new hires during orientation
• Event registration: Let attendees record their names alongside their registration
• Education: Build class rosters where students record how their names are pronounced
• CRM enrichment: Add audio name pronunciation to contact records
• Team directories: Give every team member a play button next to their name

Core concepts

Collections

A collection is a group of users whose name pronunciations you want to manage. Think of it as a roster or directory.

Users

Users are the people inside a collection. You provide their name and email — they don’t need a Nouncify account.

Embed tokens

To let users record their names, you generate an embed token and present them with the Nouncify recorder widget. No authentication required on their end.

Play links

After recording, each user gets a stable play link (e.g., https://api.nouncify.com/p/HkJ3mN8x) that you can embed anywhere.

Quick example

# 1. Create a collection
curl -X POST https://api.nouncify.com/v1/collections \
  -H "Authorization: Bearer nfy_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Engineering Team"}'

# 2. Add a user
curl -X POST https://api.nouncify.com/v1/collections/{id}/users \
  -H "Authorization: Bearer nfy_live_..." \
  -d '{"email": "priya@company.com", "first_name": "Priya", "send_invite": true}'

# 3. Get their play link (after recording)
curl https://api.nouncify.com/v1/collections/{id}/users/{user_id}/play-link \
  -H "Authorization: Bearer nfy_live_..."

Base URLs

The API base URL depends on the environment you are targeting:

• Production: https://api.nouncify.com/v1
• Sandbox (Development): https://api.sandbox.nouncify.com/v1

Note

All examples in this documentation use the Production base URL. If you are using a Development API key (nfy_dev_...), remember to replace the base URL with the Sandbox equivalent. Read more about Environments & Testing.

All API requests require a valid API key. See Authentication for details.