NEXTKIN
NEXTKINDigital Legacy
Quickstart

5-minute integration

From signup to a working API call in five steps. All endpoints live at https://nextkin.dev/api/public/v1.

  1. 1

    Sign up

    Create an account at /signup. Verify your email to access the dashboard.

  2. 2

    Create an app

    In the dashboard, go to Apps → New app API. Name it, set the inactivity period, and create. You'll see two values:

    • API key, starts with nk_live_. Shown only once. Store it now.
    • App ID, UUID visible on the app detail page.
  3. 3

    Make your first call

    Register a monitored user. Both headers are required.

    curl -X POST https://nextkin.dev/api/public/v1/users/register \
  -H "Authorization: Bearer nk_live_..." \
  -H "X-App-Id: <your-app-uuid>" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"acct_123","email":"user@example.com"}'

    Expect HTTP 201 with the registered user payload.

  4. 4

    Verify it worked

    Check the user's status:

    curl https://nextkin.dev/api/public/v1/status/acct_123 \
  -H "Authorization: Bearer nk_live_..." \
  -H "X-App-Id: <your-app-uuid>"

    Or use the Test API key button on the app detail page to run the same request from your browser.

  5. 5

    Ping on every login

    Call ping whenever the user is active to reset the inactivity timer:

    curl -X POST https://nextkin.dev/api/public/v1/users/acct_123/ping \
  -H "Authorization: Bearer nk_live_..." \
  -H "X-App-Id: <your-app-uuid>"

Troubleshooting

CodeMeaningFix
401Missing or invalid API keyConfirm Authorization: Bearer nk_live_… and that the key wasn't rotated.
403Wrong X-App-Id, or feature disabledSend the App ID for the key's app. Toggle the feature on in the app's settings.
404User not registered for this appCall /users/register first, then ping or query status.
429Rate limit exceeded100 requests/min per app. Respect Retry-After header.
Full API documentationCreate an app