---
title: "Update a sign-up"
method: PATCH
path: "/sign_ups/{id}"
tags: ["Sign Ups"]
---

# Update a sign-up

`PATCH /sign_ups/{id}`

Update the sign-up with the given ID

## Path parameters

- `id` string, required

## Request body

- object
  - `external_id` string, nullable — The ID of the guest attempting to sign up as used in your external systems or your previous authentication solution. This will be copied to the resulting user when the sign-up is completed.
  - `custom_action` boolean, nullable — If true, the sign-up will be marked as a custom action.

## Response `200`

Success

- SignUp
  - `object` 'sign_up_attempt', required
  - `id` string, required
  - `status` 'missing_requirements' | 'complete' | 'abandoned', required
  - `required_fields` string[], required
  - `optional_fields` string[], required
  - `missing_fields` string[], required
  - `unverified_fields` string[], required
  - `verifications` SignUpVerifications, required
    - `email_address` SignUpVerification, nullable, required
      - `next_action` 'needs_prepare' | 'needs_attempt' | ''
      - `supported_strategies` string[]
    - `phone_number` SignUpVerification, nullable, required
      - `next_action` 'needs_prepare' | 'needs_attempt' | ''
      - `supported_strategies` string[]
    - `web3_wallet` SignUpVerification, nullable, required
      - `next_action` 'needs_prepare' | 'needs_attempt' | ''
      - `supported_strategies` string[]
    - `external_account` object, nullable, required
  - `username` string, nullable, required
  - `email_address` string, nullable, required
  - `phone_number` string, nullable, required
  - `web3_wallet` string, nullable, required
  - `password_enabled` boolean, required
  - `first_name` string, nullable, required
  - `last_name` string, nullable, required
  - `unsafe_metadata` object
  - `public_metadata` object
  - `custom_action` boolean, required
  - `external_id` string, nullable, required
  - `created_session_id` string, nullable, required
  - `created_user_id` string, nullable, required
  - `abandon_at` integer, required — Unix timestamp at which the user abandoned the sign up attempt.
  - `legal_accepted_at` integer, nullable, required — Unix timestamp at which the user accepted the legal requirements.
  - `locale` string, nullable — The user locale preference for the sign-up specified as a BCP-47 language tag.
  - `external_account` object

## Other responses

- `403` — Authorization invalid

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/revisions/cf036e7951d3/schema)