NOTIFY

Get an sk_test_ API key instantly, with no account and no human. A test key never sends a real SMS and never spends credits, so a whole integration can be built and verified with it. Pass it as api_key to send_message and get_message, and keep it in the application's configuration (for example NOTIFY_API_KEY), never in source code. The result also has a claim_url for a human: opening it lets them sign in and take over the project. Anyone who opens it, signs in and confirms becomes the owner: give it only to the person who will own the project, and do not paste it into shared logs or tickets. Real SMS need an sk_live_ key that the human creates on the dashboard (https://n0t1fy.dev/dashboard). Limited to a few keys per minute and per day for each address: reuse a key you already have.

Read the current state of a message sent with a key of the same project. Poll only while status is queued or submitted: delivered, undeliverable and failed are final, and unknown never changes. Wait about 2 seconds before the first read and double the wait each time, up to 30 seconds. Always set a time limit (two minutes is generous for a test message); when it passes, treat the message as unconfirmed and do not send it again.

Send one transactional SMS to a Georgian mobile number. The text comes from a built-in template; there is no free text.

With a test key (sk_test_) nothing is really sent: a simulator answers. These recipients simulate outcomes: +995500000001 rejected (status failed); +995500000002 provider unreachable (error provider_unavailable: nothing was sent, retry with the same idempotency_key); +995500000003 ambiguous (status unknown); +995500000004 accepted, then undeliverable. Any other valid number is accepted, then delivered, within about 30 seconds. With a live key it sends a real SMS and spends one credit per segment.

Read message.status in the result. submitted: the provider accepted it, which is not yet delivery to the phone. failed: refused; message.error says why. unknown: it may or may not have been sent, so do not send it again automatically. replayed: true: this idempotency_key and request were already processed, and no second SMS was sent. Call get_message to learn the final outcome.