> ## 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), skill for building with Turnkey (https://docs.turnkey.com/skill.md), agent skills for operating an organization (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 a Fiat Ramp credential

> Create a fiat ramp provider credential.

POST

/

public

/

v1

/

submit

/

create\_fiat\_ramp\_credential

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

> [tab] 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).

> [tab] 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_FIAT_RAMP_CREDENTIAL`

**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.
provider

enum\<string>

required

Enum options: `FIAT_RAMP_PROVIDER_COINBASE`, `FIAT_RAMP_PROVIDER_MOONPAY`, `FIAT_RAMP_PROVIDER_MELD`

Navigate to header

parameters.
apiKey

string

required

Non-secret half of the provider credential. MoonPay: publishable key (pk\_test\_ or pk\_live\_). Coinbase: CDP API key ID

Navigate to header

parameters.
encryptedSecret

string

required

Secret half of the provider credential, encrypted to our on-ramp encryption public key. MoonPay: secret key (sk\_test\_ or sk\_live\_). Coinbase: Ed25519 private key

Navigate to header

parameters.
sandboxMode

boolean

If the credential is a sandbox credential

**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.
createFiatRampCredentialIntent

object

required

The createFiatRampCredentialIntent object

**createFiatRampCredentialIntent details**

Navigate to header

activity.intent.createFiatRampCredentialIntent.
provider

enum

required

provider field

Enum options: `FIAT_RAMP_PROVIDER_COINBASE`, `FIAT_RAMP_PROVIDER_MOONPAY`, `FIAT_RAMP_PROVIDER_MELD`

Navigate to header

activity.intent.createFiatRampCredentialIntent.
apiKey

string

required

Non-secret half of the provider credential. MoonPay: publishable key (pk\_test\_ or pk\_live\_). Coinbase: CDP API key ID

Navigate to header

activity.intent.createFiatRampCredentialIntent.
encryptedSecret

string

required

Secret half of the provider credential, encrypted to our on-ramp encryption public key. MoonPay: secret key (sk\_test\_ or sk\_live\_). Coinbase: Ed25519 private key

Navigate to header

activity.intent.createFiatRampCredentialIntent.
sandboxMode

boolean

If the credential is a sandbox credential

Navigate to header

activity.
result

object

required

The result of the activity

**result details**

Navigate to header

activity.result.
createFiatRampCredentialResult

object

required

The createFiatRampCredentialResult object

**createFiatRampCredentialResult details**

Navigate to header

activity.result.createFiatRampCredentialResult.
credentialId

string

required

Unique identifier of the fiat ramp credential that was created

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_fiat_ramp_credential \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header "X-Stamp: <string> (see Authorizations)" \
  --data '{
    "type": "ACTIVITY_TYPE_CREATE_FIAT_RAMP_CREDENTIAL",
    "timestampMs": "<string> (e.g. 1746736509954)",
    "organizationId": "<string> (Your Organization ID)",
    "parameters": {
        "provider": "<FIAT_RAMP_PROVIDER_COINBASE>",
        "apiKey": "<string>",
        "encryptedSecret": "<string>",
        "sandboxMode": "<boolean>"
    }
}'
```

```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().createFiatRampCredential({
  provider: "<FIAT_RAMP_PROVIDER_COINBASE>" // provider field,
  apiKey: "<string> (Non-secret half of the provider credential. MoonPay: publishable key (pk_test_ or pk_live_). Coinbase: CDP API key ID)",
  encryptedSecret: "<string> (Secret half of the provider credential, encrypted to our on-ramp encryption public key. MoonPay: secret key (sk_test_ or sk_live_). Coinbase: Ed25519 private key)",
  sandboxMode: true // If the credential is a sandbox credential
});
```

```json 200 theme={"system"}
{
  "activity": {
    "id": "<activity-id>",
    "status": "ACTIVITY_STATUS_COMPLETED",
    "type": "ACTIVITY_TYPE_CREATE_FIAT_RAMP_CREDENTIAL",
    "organizationId": "<organization-id>",
    "timestampMs": "<timestamp> (e.g. 1746736509954)",
    "result": {
      "activity": {
        "id": "<string>",
        "organizationId": "<string>",
        "status": "<string>",
        "type": "<string>",
        "intent": {
          "createFiatRampCredentialIntent": {
            "provider": "<FIAT_RAMP_PROVIDER_COINBASE>",
            "apiKey": "<string>",
            "encryptedSecret": "<string>",
            "sandboxMode": "<boolean>"
          }
        },
        "result": {
          "createFiatRampCredentialResult": {
            "credentialId": "<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.