Update & delete - Whop Docs

Update a verification

Update fields on a verification that hasn’t been approved yet. Use this to correct pre-filled data before the user completes KYC.

cURL

curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Janet",
    "last_name": "Smith"
  }'

Updatable fields

Field	Description
`first_name`	Legal first name
`last_name`	Legal last name
`date_of_birth`	ISO date
`country`	ISO alpha-2 country code
`personal_address`	Residential address object
`business_name`	Legal business name
`business_address`	Registered business address
`business_structure`	Legal entity structure — every value and its countries in Business structures

You can’t update a verification that’s already approved. The identity data is locked once verified. Delete it and create a new one if you need to start over.

Delete a verification

Remove a verification from an account. The data stays in our system but the verification is unlinked and won’t appear in the list.

cURL

curl -X DELETE https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY"

Response

{
  "id": "idpf_xxxxxxxxxxxxx",
  "deleted": true
}

After deleting, call POST /api/v1/verifications to start fresh with a new verification.

Deleting doesn’t cancel an in-flight KYC session — it unlinks the verification from the account. The session expires on its own at the provider.

Restart a verification

If a user’s KYC was declined or they need to redo it, you don’t need to delete and recreate. Call create with restart: true:

cURL

curl -X POST https://api.whop.com/api/v1/verifications \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "biz_xxxxxxxxxxxxx",
    "kind": "individual",
    "restart": true
  }'

This abandons the old session and gives you a fresh session_url.

Authentication

All write endpoints require a Company API key with the identity:write scope.

Errors

Status	Message	When
`400`	`Cannot update an approved verification.`	Profile is already verified
`400`	`at least one field is required`	Empty request body
`401`	—	Missing or invalid API key
`403`	—	API key lacks `identity:write` scope
`404`	`Verification not found`	The `idpf_` ID doesn’t exist or isn’t visible

​Update a verification

​Updatable fields

​Delete a verification

​Restart a verification

​Authentication

​Errors

Update a verification

Updatable fields

Delete a verification

Restart a verification

Authentication

Errors