SMS Verification

POST https://api.kickofflabs.com/v2/CAMPAIGN_ID/verify-phone-number

Verify a lead’s phone number with a confirmation code.

Required Parameters

• api_key: Your account’s API Key
• phone_number (recommended), email, or social_id: The identity of the lead you wish to verify.
• code: The code sent to the lead’s phone number.

You should know!

This API only works with Twilio’s SMS Verification service and it must be configured on your campaign before you can use it.

If you want to verify a lead without using Twilio, you can use the generic Verify Lead API.

JSON response

Successful response:

{ "message": "Lead verified" }

Errors

• If SMS verification is not configured, KickoffLabs returns 409 with Missing required Twilio information.
• Missing code returns 409 with Verification code not found.
• Missing lead identifier returns 409 with Please include a lead id or email.
• No matching lead returns 404 with No lead found.
• Already verified phone numbers return 409 with Lead already verified.
• Invalid verification codes return 404 with Verification code is not valid.