Appearance
SDK Reference
The funnelgrove SDK is an HTTP API. Use the public API from funnels, mobile apps, and browser code. Use the private API only from your backend.
Base URL:
text
https://sdk-api.funnelsgrove.comGet SDK Keys
Open the funnelgrove dashboard, select your project, then open Project Settings. Copy the SDK publishable key for public API calls and the SDK secret key for private server-side calls.
The publishable key is safe to expose in browser or mobile app code. The secret key is not; store it only on your backend.
Key rotation behavior:
| Key | Used by | Rotation behavior |
|---|---|---|
| SDK publishable key | Public API | Old key keeps working for 30 days. |
| SDK secret key | Private API | Old key stops working immediately. |
API Split
| API | Auth header | Use for |
|---|---|---|
| Public API | X-SDK-Publishable-Key | App subscription status checks and subscription claim after login. |
| Private API | X-SDK-Secret-Key | Backend reads, user lookup, user lists, and server-side subscription actions. |
Required IDs
Most requests include funnelId so the API can scope the request to the right funnel. App handoff and subscription claim flows also use user_id, the funnelgrove user id passed in the deep link.