Skip to content
Contactivity

Contactivity Verify: phone verification API

Check that a user owns a phone number. We call it and speak a one-time code, and your app checks the code with one API call. The code is never returned by the API.

How it works

  1. 1

    Create a profile

    Once per app or flow: language, brand name, spoken phrases, code length, expiry, repeats and attempts.

  2. 2

    Start a verification

    Send the number. We call it and speak the code slowly, twice by default. The user can press 1 to hear it again.

  3. 3

    Check the code

    Your server sends the digits the user typed. approved means the user owns the number.

Features

Code never returned
We generate the code. It is not in any response, webhook, event or log, so it cannot leak from your servers.
Profiles
Code length 4 to 10 digits, expiry, times the code is repeated, check attempts and the brand name spoken first.
Languages
English (US), Spanish, French, German and Italian, in a built-in voice.
Phrase presets
Pick the intro, the line before the code and the closing line from fixed presets. No free text, so calls cannot be misused.
Voicemail
Machine detection is on by default. If voicemail answers, the code plays after the beep.
Caller ID
Calls come from our managed Verify numbers, signed with full attestation.
Countries
US and Canada by default. Other countries once international calling is approved for your project.
Built-in protection
Rate limits per number, per area code and per project. A profile can pause itself when its approval rate collapses.
Webhooks
verification.call.answered, verification.call.failed, verification.approved and verification.expired. No event carries the code.
SDKs and sandbox
Node and Python SDKs. Test numbers simulate answered, voicemail, busy and no-answer calls without placing one.

Start and check

// Start: we call the number and speak the codeconst v = await client.verifications.create({ to: "+14155550123", profile_id: profile.id });// Check the digits the user typedconst { result } = await client.verifications.check(v.id, { code: "481293" });if (result === "approved") markPhoneVerified(user);

Questions

Can I see or choose the code?

No. We generate it, and it is never returned by the API or sent in a webhook. Your app only sends the digits the user typed.

What if voicemail answers?

Machine detection is on by default, and the code plays after the beep. Each detection run is billed.

What number does the call come from?

Our managed Verify numbers, signed with full attestation. You do not choose the caller ID.

Which languages are spoken?

English (US), Spanish, French, German and Italian. Each profile picks one, and its intro, lead-in and closing line from fixed presets.

Can the code be sent by text message?

No. Contactivity Verify is voice only.

Can I test without placing calls?

Yes. In a sandbox project, test numbers simulate each call result with a known code, and cost nothing.

Start in the sandbox

Try trunks, voice apps and flows with calls to your own verified numbers, before you add a card.

Create an account