Skip to main content
POST
/
v2
/
studio
/
deployment
/
account-association
Set account association
curl --request POST \
  --url https://api.neynar.com/v2/studio/deployment/account-association \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "account_association": {
    "header": "<string>",
    "payload": "<string>",
    "signature": "<string>"
  },
  "deployment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "fid": 3,
  "name": "<string>",
  "namespace": "<string>"
}
'
{
  "success": true,
  "message": "<string>"
}
The Miniapp Studio API is an allowlisted API and not publicly available. Contact the Neynar team for more information.

Node.js SDK

🔗 SDK Method: associateDeployment Use this API endpoint with the Neynar Node.js SDK for typed responses and better developer experience.

Authorizations

x-api-key
string
header
default:NEYNAR_API_DOCS
required

API key to authorize requests

Body

application/json
account_association
object
required

Signed domain association linking this deployment to a Farcaster account

deployment_id
string<uuid>

Deployment ID (UUID). Required if name not provided.

fid
integer<int32>

Farcaster ID of the user; if not provided, namespace must be provided

Required range: x >= 0
Example:

3

name
string

Kubernetes deployment name. Required if deployment_id not provided.

namespace
string

Optional Kubernetes namespace. If not provided, will query for the active namespace for the given FID.

Response

Success

success
boolean
required
message
string
required

Status message from the miniapp generator