Search for a command to run...
Start here
10–15 minCreate the credentials, connect a client channel, make a safe test request, and prepare the same integration for live delivery.
All public partner endpoints use the dedicated API host and a pinned version prefix.
https://api.intelliconcierge.dev/v1Sign up and open the dashboard. IntelliPortal provisions the partner account automatically; you do not need to register an API application separately.
Create an accountIn API Keys, create keys with clients:read, clients:write, and messages:send. Copy each secret when it appears; only its prefix is stored for later identification.
Use each mode for one job
ik_test_ for payload validation and ik_live_ for hosted channel onboarding and real delivery. Test-key traffic never delivers and never counts toward usage.Pick a durable identifier from your own database. IntelliPortal treats client_ref as your integration's foreign key and returns it on client records and webhook events.
curl -X POST https://api.intelliconcierge.dev/v1/embedded-signup/sessions \
-H "Authorization: Bearer $INTELLI_LIVE_KEY" \
-H "Content-Type: application/json" \
-d '{ "client_ref": "customer_42" }'The response contains session_id, url, and expires_in: 600. Open the URL in a popup or a new tab.
The hosted page posts a completion message to its opener. Treat that browser event as a UX signal, then verify the client server-to-server before enabling sends.
curl https://api.intelliconcierge.dev/v1/clients/customer_42 \
-H "Authorization: Bearer $INTELLI_LIVE_KEY"The first connection starts the trial
402 trial_expired, while test and dry-run requests remain available.Authenticate with the test key. IntelliPortal runs the same request validation and routing checks but does not deliver to the recipient.
curl -X POST https://api.intelliconcierge.dev/v1/messages/send \
-H "Authorization: Bearer $INTELLI_TEST_KEY" \
-H "Content-Type: application/json" \
-d '{
"client_ref": "customer_42",
"to": "+254700000000",
"type": "text",
"text": { "body": "Your IntelliPortal integration works." }
}'{
"success": true,
"message_id": "wamid.TEST_...",
"dry_run": true
}Save an HTTPS endpoint in the dashboard's Webhooks section, copy the signing secret, then use the simulator. A production handler should verify the raw-body signature and return a 2xx response within five seconds.
Implement a webhook receiverSwap the test key for the live key in your server environment. Do not change the endpoint or request shape. Before rollout, confirm each item below.