Customers

Generate a setup link

Creates a one-time setup link the end-customer can use to complete Meta Embedded Signup. The token is embedded in setup_url; there is no separate token field. Store the URL immediately. It is returned in the initial response and replayed for 24 hours when the same POST is retried with the same Idempotency-Key; outside that replay it is not returned again.

post/customers/{id}/setup_links

Request

  • Base URL: https://api.kirimdev.com/v1
  • URL: https://api.kirimdev.com/v1/customers/{id}/setup_links
  • Auth: HTTP bearer

Path parameters

idstring required

Public Kirimdev end-customer ID.

Example:cus_01HXYZABCDEFGHJKMNPQRSTVWX

Headers

Idempotency-Keystring

Optional retry key. Reusing the same key with the same method, path, and body within 24 hours returns the original response; reusing it for a different request returns 422.

Example:order-20260910-0001

Request body

expires_in_hoursinteger
success_redirect_urlstring uri
failure_redirect_urlstring uri

Response

Setup link created (token included in this idempotently replayable response)

request_idstring required

Unique request identifier to include when contacting support.

Example response

{
  "data": {
    "id": "csl_01HXYZABCDEFGHJKMNPQRSTVWX"
  },
  "request_id": "req_01HXYZABCDEFGHJKMNPQRSTVWX"
}

Changes

No recorded changes to this operation across all 1 revision of this API.