New Caledonia (+687) verification codes for product and QA teams

One-time code or long-term line: which does a New Caledonia project need?

Decide this first, because it shapes the rest of the integration.

• OTP Gateway numbers are for a single verification. You reserve a +687 number, receive one code, and the activation ends. This suits sign-up tests, localisation checks and CI runs that create a fresh test account each time.
• Dedicated Numbers are lines you keep while they renew, with inbound and outbound SMS plus browser calling. They are sold only in the United States and Canada, from $1.95/month, and there is no self-serve equivalent for New Caledonia.

If a New Caledonian line has to stay with an account for months, email [email protected] and describe the use case; availability depends on local rules and cannot be promised. For anything that needs one code at a time, the gateway is the right tool. Our comparison of temporary vs dedicated numbers goes deeper.

How is the OTP Gateway called for the New Caledonia route?

All requests hit https://otproute.com/api/v1 with a Bearer key prefixed or_live_. Generate keys in the Developer console, up to 10 per account, and rotate them per environment.

1. Look up the route in GET /api/v1/countries; New Caledonia uses the id nc.
2. Fetch service ids from GET /api/v1/services.
3. Ask GET /api/v1/prices?country=nc&service=<id> for the live price and availability.
4. Create the activation with POST /api/v1/activations and a body like {"service": "facebook", "country": "nc"}. Keep the returned activation id.
5. Enter the +687 number in the app you are testing.
6. Receive the code by webhook or poll GET /api/v1/activations/{id}. Call POST /api/v1/activations/{id}/cancel when a test is abandoned.

GET /api/v1/balance is worth calling before a batch so the run fails fast on an empty wallet. The developers page collects SDK notes and docs for this New Caledonia OTP API.

What do signed webhooks look like for +687 codes?

Register up to 5 endpoints and choose the events you need: activation.sms_received, activation.expired and activation.cancelled. Each delivery arrives with an X-OTPRoute-Signature header shaped t=<unix>,v1=<hex>.

To trust a delivery, sign <t>.<raw body> with HMAC-SHA256 and your endpoint secret, then compare it to v1 in constant time. Throw away anything with an old timestamp. Because the same event may be sent again, index processed events by activation id and skip duplicates. Teams that would rather poll can do so within the 300 requests per minute ceiling.

Which services can receive New Caledonia SMS OTP codes?

The route currently carries more than 700 services. The live snapshot includes WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Airbnb, Uber, Netflix, Telegram, LinkedIn, Snapchat and TikTok.

The catalogue is smaller than on larger markets and shifts through the day, so always read availability from the API at the moment you order. If a service is missing, check again later or plan the test around a neighbouring route.

What makes +687 numbers different for validation and localisation?

New Caledonia uses a closed six-digit numbering plan with no trunk prefix, so the E.164 form is simply +687 followed by six digits. Validators tuned for longer national numbers often reject it, which makes this a useful edge case for any phone field. Store the full E.164 string and avoid length rules copied from another market.

French is the official language, alongside many Kanak languages spoken across the islands. Expect verification messages in French or English, and make sure templates with accented characters render correctly in your logs. The territory runs on UTC+11 without daylight saving, which matters if your tests assert on timestamps or expiry times.

Teams come here to QA French-language flows outside Europe, to support tourism and hospitality products, and to verify accounts for regional operations in the Pacific. The mobile app verification page covers how app teams set up these checks.

How can a non-developer get a New Caledonia verification number?

The dashboard needs no code. Sign up with your email and a 6-digit code, or Google, and enable TOTP. Fund the wallet, choose New Caledonia and the service, and confirm after reviewing the displayed price. Paste the +687 number into the app, then watch the activation until the code appears.

What if nothing arrives within 20 minutes?

You only pay if the code arrives. When the window expires empty, or you cancel, the full charge goes back to the wallet automatically.

• Give the activation its full time; delivery depends on the service and the route.
• Retry at a later hour, or with another service route if the test allows.
• Find out whether the service accepts virtual numbers. Some decline them, which is what the refund protects you from.
• Avoid ordering again in a rapid loop; spread out attempts and log each activation id.

How is a New Caledonia test billed?

Everything draws from one prepaid USD wallet. There is no monthly fee and no plan to select. Add funds by card or with USDT/USDC, and a PDF invoice is emailed for every top-up. For integration work, request sandbox mode on a development account to receive simulated numbers and codes at no cost to the wallet.

OTP Route is meant for testing and running your own legitimate products and accounts. Pacific-market tests still fall under each service's own terms and under our Acceptable Use Policy.

Frequently asked questions

Can I test a New Caledonia sign-up flow without a local SIM card?

Yes. Order a +687 number from the OTP Gateway, use it in your app and read the code in the dashboard or via the API.

What is the API country id for New Caledonia?

It is nc, used in both the prices query and the activation request body.

How long is a New Caledonia phone number?

Six digits after the +687 country code, with no trunk prefix. Store it in E.164 and don't apply length rules from other countries.

How much is a +687 number for testing?

From $0.20 per code, with the exact live price per service returned by GET /api/v1/prices before you order.

Can I rent a long-term New Caledonia number?

No self-serve option exists there; long-term Dedicated Numbers are US and Canada only. You can email [email protected] to ask about a New Caledonian line.

In what language will New Caledonian OTP messages arrive?

Usually French or English, depending on the service. Parse the numeric code so both work.

Is a +687 order refunded when the code never comes?

Yes, the wallet gets the full amount back automatically once the 20-minute window closes or you cancel.

Service names are trademarks of their respective owners. OTP Route is not affiliated with them. Use numbers lawfully, follow each service's terms and our Acceptable Use Policy.