> ## Documentation Index
> Fetch the complete documentation index at: https://docs.turnkey.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Turnkey is wallet infrastructure: create and manage crypto wallets, sign transactions, and enforce policy-based access controls. Best-fit uses: embedded consumer wallets (email/passkey/social auth, no seed phrases), automated onchain operations with server-side wallets, AI agent wallets with policy-scoped signing, enterprise key management, and verifiable off-chain workloads on Turnkey Verifiable Cloud (TVC).
> Every API call is a JSON POST to https://api.turnkey.com signed with a P-256 API key; create an organization and key self-serve at https://app.turnkey.com.
> Key Turnkey developer resources: API reference (https://docs.turnkey.com/api-reference/overview/intro.md), OpenAPI spec (https://docs.turnkey.com/public_api.swagger.json), authentication (https://docs.turnkey.com/features/authentication/overview.md), webhooks (https://docs.turnkey.com/features/webhooks/overview.md), MCP server for docs search (https://docs.turnkey.com/mcp), agent skills (https://docs.turnkey.com/get-started/ai-skills.md), CLI (https://docs.turnkey.com/sdks/cli.md), SDK reference (https://docs.turnkey.com/sdks/introduction.md), full docs content (https://docs.turnkey.com/llms-full.txt).

# Create wallet authenticators

> Add wallet authenticators to an existing user. Omit verification_token to attach unverified.

POST

/

public

/

v1

/

submit

/

create\_wallet\_authenticators

Activity requests must meet the [signed-request validity window](https://docs.turnkey.com/api-reference/activities/overview.md#signed-request-validity) for `timestampMs` and the applicable [rate limits](https://docs.turnkey.com/reference/rate-limits.md).

### Authorizations

**API Key**

**X-Stamp** `string` *required*

Cryptographically signed (stamped) request to be passed in as a header. For more info, see [here](https://docs.turnkey.com/developer-reference/api-overview/stamps.md).

**WebAuthn (Passkey)**

**X-Stamp-WebAuthn** `string` *required*

Cryptographically signed (stamped) request to be passed in as a header. For more info, see [here](https://docs.turnkey.com/developer-reference/api-overview/stamps.md).

### Body

**type** `enum\<string\>` *required*

Enum options: `ACTIVITY_TYPE_CREATE_WALLET_AUTHENTICATORS`

**timestampMs** `string` *required*

Timestamp (in milliseconds) of the request, used to verify liveness of user requests.

**organizationId** `string` *required*

Unique identifier for a given Organization.

**parameters** `object` *required*

The parameters object containing the specific intent data for this activity.

**details**

Navigate to header

parameters.
userId

string

required

The ID of the User to add wallet authenticators to.

**parameters.walletAuthenticators** `array` *required*

Wallet authenticators to add. Each entry is a type, address, and domain. verification\_token is optional.

**item details**

Navigate to header

parameters.walletAuthenticators.
type

enum\<string>

required

Enum options: `WALLET_AUTHENTICATOR_TYPE_ETHEREUM`, `WALLET_AUTHENTICATOR_TYPE_SOLANA`

Navigate to header

parameters.walletAuthenticators.
address

string

required

Account address. Ethereum addresses are stored lowercase with a 0x prefix. Solana addresses are canonical base58.

Navigate to header

parameters.walletAuthenticators.
domain

string

required

SIWE/SIWS domain this authenticator is bound to. Host only, lowercased.

Navigate to header

parameters.walletAuthenticators.
verificationToken

string

Wallet verification JWT for this claim. Omit to attach the authenticator unverified.

**generateAppProofs** `boolean`

Enable to have your activity generate and return App Proofs, enabling verifiability.

### Response

A successful response returns the following fields:

**activity** `object` *required*

The activity object containing type, intent, and result

**activity details**

Navigate to header

activity.
id

string

required

Unique identifier for a given Activity object.

Navigate to header

activity.
organizationId

string

required

Unique identifier for a given Organization.

Navigate to header

activity.
status

string

required

The activity status

Navigate to header

activity.
type

string

required

The activity type

Navigate to header

activity.
intent

object

required

The intent of the activity

**intent details**

Navigate to header

activity.intent.
createWalletAuthenticatorsIntent

object

required

The createWalletAuthenticatorsIntent object

**createWalletAuthenticatorsIntent details**

Navigate to header

activity.intent.createWalletAuthenticatorsIntent.
userId

string

required

The ID of the User to add wallet authenticators to.

Navigate to header

activity.intent.createWalletAuthenticatorsIntent.
walletAuthenticators

array

required

Wallet authenticators to add. Each entry is a type, address, and domain. verification\_token is optional.

**walletAuthenticators details**

Navigate to header

activity.intent.createWalletAuthenticatorsIntent.walletAuthenticators.
type

enum

required

type field

Enum options: `WALLET_AUTHENTICATOR_TYPE_ETHEREUM`, `WALLET_AUTHENTICATOR_TYPE_SOLANA`

Navigate to header

activity.intent.createWalletAuthenticatorsIntent.walletAuthenticators.
address

string

required

Account address. Ethereum addresses are stored lowercase with a 0x prefix. Solana addresses are canonical base58.

Navigate to header

activity.intent.createWalletAuthenticatorsIntent.walletAuthenticators.
domain

string

required

SIWE/SIWS domain this authenticator is bound to. Host only, lowercased.

Navigate to header

activity.intent.createWalletAuthenticatorsIntent.walletAuthenticators.
verificationToken

string

Wallet verification JWT for this claim. Omit to attach the authenticator unverified.

Navigate to header

activity.
result

object

required

The result of the activity

**result details**

Navigate to header

activity.result.
createWalletAuthenticatorsResult

object

required

The createWalletAuthenticatorsResult object

**createWalletAuthenticatorsResult details**

Navigate to header

activity.result.createWalletAuthenticatorsResult.
walletAuthenticatorIds

array

required

IDs of the wallet authenticators created.

**walletAuthenticatorIds details**

Navigate to header

activity.result.createWalletAuthenticatorsResult.walletAuthenticatorIds.
item

string

required

item field

Navigate to header

activity.
votes

array

required

A list of objects representing a particular User's approval or rejection of a Consensus request, including all relevant metadata.

Navigate to header

activity.
fingerprint

string

required

An artifact verifying a User's action.

Navigate to header

activity.
canApprove

boolean

required

Whether the activity can be approved.

Navigate to header

activity.
canReject

boolean

required

Whether the activity can be rejected.

Navigate to header

activity.
createdAt

string

required

The creation timestamp.

Navigate to header

activity.
updatedAt

string

required

The last update timestamp.

```bash title="cURL" theme={"system"}
curl --request POST \
  --url https://api.turnkey.com/public/v1/submit/create_wallet_authenticators \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header "X-Stamp: <string> (see Authorizations)" \
  --data '{
    "type": "ACTIVITY_TYPE_CREATE_WALLET_AUTHENTICATORS",
    "timestampMs": "<string> (e.g. 1746736509954)",
    "organizationId": "<string> (Your Organization ID)",
    "parameters": {
        "userId": "<string>",
        "walletAuthenticators": [
            {
                "type": "<WALLET_AUTHENTICATOR_TYPE_ETHEREUM>",
                "address": "<string>",
                "domain": "<string>",
                "verificationToken": "<string>"
            }
        ]
    }
}'
```

```javascript title="JavaScript" theme={"system"}
import { Turnkey } from "@turnkey/sdk-server";

const turnkeyClient = new Turnkey({
  apiBaseUrl: "https://api.turnkey.com",
  apiPublicKey: process.env.API_PUBLIC_KEY!,
  apiPrivateKey: process.env.API_PRIVATE_KEY!,
  defaultOrganizationId: process.env.ORGANIZATION_ID!,
});

const response = await turnkeyClient.apiClient().createWalletAuthenticators({
  userId: "<string> (The ID of the User to add wallet authenticators to.)",
  walletAuthenticators: [{ // Wallet authenticators to add. Each entry is a type, address, and domain. verification_token is optional.,
    type: "<WALLET_AUTHENTICATOR_TYPE_ETHEREUM>" // type field,
    address: "<string> (Account address. Ethereum addresses are stored lowercase with a 0x prefix. Solana addresses are canonical base58.)",
    domain: "<string> (SIWE/SIWS domain this authenticator is bound to. Host only, lowercased.)",
    verificationToken: "<string> (Wallet verification JWT for this claim. Omit to attach the authenticator unverified.)",
  }]
});
```

```json 200 theme={"system"}
{
  "activity": {
    "id": "<activity-id>",
    "status": "ACTIVITY_STATUS_COMPLETED",
    "type": "ACTIVITY_TYPE_CREATE_WALLET_AUTHENTICATORS",
    "organizationId": "<organization-id>",
    "timestampMs": "<timestamp> (e.g. 1746736509954)",
    "result": {
      "activity": {
        "id": "<string>",
        "organizationId": "<string>",
        "status": "<string>",
        "type": "<string>",
        "intent": {
          "createWalletAuthenticatorsIntent": {
            "userId": "<string>",
            "walletAuthenticators": [
              {
                "type": "<WALLET_AUTHENTICATOR_TYPE_ETHEREUM>",
                "address": "<string>",
                "domain": "<string>",
                "verificationToken": "<string>"
              }
            ]
          }
        },
        "result": {
          "createWalletAuthenticatorsResult": {
            "walletAuthenticatorIds": [
              "<string>"
            ]
          }
        },
        "votes": "<array>",
        "fingerprint": "<string>",
        "canApprove": "<boolean>",
        "canReject": "<boolean>",
        "createdAt": "<string>",
        "updatedAt": "<string>"
      }
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.