---
title: "Register Signed Key"
method: POST
path: "/v2/farcaster/signer/signed_key/"
tags: ["Signer"]
---

# Register Signed Key

`POST /v2/farcaster/signer/signed_key/`

Registers an app FID, deadline and a signature. Returns the signer status with an approval url.

## Request body

- RegisterSignerKeyReqBody
  - `app_fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
  - `deadline` integer, required — unix timestamp in seconds that controls how long the signed key request is valid for. (24 hours from now is recommended)
  - `redirect_url` string — Url to redirect to after the signer is approved. **Note** : This should only be used when requesting a signer from a native mobile application.
  - `signature` string, required — Signature generated by the custody address of the app. Signed data includes app_fid, deadline, signer's public key
  - `signer_uuid` string, required — UUID of the signer. `signer_uuid` is paired with API key, can't use a `uuid` made with a different API key.
  - `sponsor` SignedKeyRequestSponsor
    - `fid` integer — The unique identifier of a farcaster user or app (unsigned integer)
    - `signature` string — Signature generated by the fid of the sponsor and the signature generated from signKeyRequest for the app.
    - `sponsored_by_neynar` boolean — Neynar will sponsor the signer if set to true. **Note: ** If sponsor.fid and sponsor.signature are provided along with sponsored_by_neynar set to true, the sponsor.fid and sponsor.signature will be ignored. Neynar will sponsor the signer on behalf of the user. The developer will get charged in credits.

## Response `200`

Success

- Signer
  - `fid` integer — The unique identifier of a farcaster user or app (unsigned integer)
  - `object` 'signer'
  - `permissions` SharedSignerPermission[]
  - `public_key` string, required — Ed25519 public key
  - `signer_approval_url` string
  - `signer_uuid` string, required — UUID of the signer. `signer_uuid` is paired with API key, can't use a `uuid` made with a different API key.
  - `status` 'generated' | 'pending_approval' | 'approved' | 'revoked', required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Resource not found
- `500` — Server Error

---

[API](https://skmtc.dev/neynar/apis/neynar-api.md) · [All operations](https://skmtc.dev/neynar/apis/neynar-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/neynar/neynar-api/revisions/dbb91bfb0d1a/schema)
