Set share token for verification creation intent

UAT Env

PATCH

/verification-creation-intents/{verification_creation_intent_id}/share-token

Requires scope verification-creation-intent:update.

Supplies the credential for an intent created with origin donor-reuse: the share token the end user's existing verified profile issued. The token is write only and is never returned.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/verification-creation-intents/0199be49-f31c-77aa-8e66-811c3192a50e/share-token' \
--header 'If-Match;' \
--header 'x-fomo-api-version: v20260326' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "share_token": "share-token-example"
}'

Response Example

{
    "id": "0199ba56-1452-770c-8e6b-3bebd1dd012b",
    "create_time": "2026-10-05T03:12:45.123Z",
    "update_time": "2026-10-05T03:12:45.123Z",
    "token": "AZm0pm8ufDGaO10ujxxKEA",
    "etag": "\"AZm0pm8ufDGaO10ujxxKEAAAAAAAAAAB\"",
    "life_cycle": "pending-requirements",
    "result": "pending",
    "fail_reason": null,
    "customer_id": "0199b1e3-8d67-7dbe-88f4-7d244e0ba9ff",
    "customer_party_ref": "customer-ref-0001",
    "party_id": "0199b940-1c40-720f-8068-5d8d3f10afa2",
    "requested_capabilities": [
        "hold-balance"
    ],
    "origin": "direct",
    "collection_channel": null,
    "requirements": [
        {
            "requirement_id": "0199b910-563c-7fa8-8a06-d552e92b3cb0",
            "revision": 1
        }
    ],
    "confirm_time": null,
    "approve_time": null,
    "complete_time": null,
    "verification_id": "0199b900-4c68-7a4b-81d3-7de2402fff98",
    "collection_session_id": "0199bf88-a6a6-79e3-8b1d-4cbb4f698b7f"
}

Create a verification creation intent

Answer a requirement for verification creation intent