MEmeow
Transfers

Create Crypto Transaction

Creates a new crypto transaction from a specified account. The currency and network are determined automatically from the destination's payment method. Provide exactly one of static_memo_id or crypto_id to identify the destination:

  • static_memo_id: Use the ID from the contact's payment_methods.static_memos array. Supported for both banking and wallet accounts.
  • crypto_id: Use the ID from the contact's payment_methods.crypto array. Supported for both banking and wallet accounts.

Supported currencies: usdc, usdt, pyusd, cash, usdg, path_usd.

Requires the transfers:crypto:write scope. Use this endpoint for all crypto transfers. The legacy /usdc endpoint is deprecated.

post/accounts/{account_id}/crypto

Request

Path parameters

account_idstring required

The ID of the account.

Headers

Idempotency-Keystring nullable

A unique key you generate (1-50 printable ASCII characters, no spaces) so retrying this request never creates a duplicate. Reusing a key is rejected.

x-entity-idstring uuid

Optional entity_id to scope requests to a specific entity.

Request body

static_memo_idstring uuid nullable

Destination static memo. Provide exactly one of static_memo_id or crypto_id.

crypto_idstring uuid nullable

Destination crypto address on a contact. Provide exactly one of static_memo_id or crypto_id.

internal_notestring nullable

Private note, visible only inside Meow.

emailsstring[] nullable

Addresses to notify when the transaction is sent, as a list.

metadataobject nullable

Your own key/value data to attach to this object. Meow stores it unchanged and returns it on every read of the object and on every webhook event about it, so you can match it back to your own records. Up to 20 pairs; keys up to 40 characters, values up to 200, and 5 KB serialized as JSON in total — note that a non-ASCII character counts as 6 bytes and an emoji as 12. Values must be strings. Meow never interprets it — do not put anything here that needs to stay private.

Response

Successful Response

status'pending' | 'pending_approval' | 'canceled' | 'processing' | 'error' | 'sent' | 'returned' | 'void' required
amountstring required

Amount sent, in USD. Echoes the request.

internal_notestring nullable

Private note, visible only inside Meow. Echoes the request.

created_timeinteger required

When the transaction was created, as a Unix timestamp in seconds.

destination_addressstring required

On-chain address the funds were sent to.

destination_payment_rail'arbitrum' | 'avalanche_c_chain' | 'base' | 'ethereum' | 'optimism' | 'polygon' | 'solana' | 'stellar' | 'sui' | 'tempo' | 'tron' | 'xdc' | 'ach' | 'ach_push' | 'ach_same_day' | 'fednow' | 'wire' | 'swift' | 'sepa' | 'faster_payments' | 'spei' | 'bridge_transfer' required
destination_address_nicknamestring nullable

Nickname of the contact that owns the destination address. null when the address is not attached to a contact.

approval_idstring uuid required

Handle for this transaction, returned whether or not an approval policy gated it. Pass it to GET /approvals/{approval_id} to follow the transaction to completion.

messagestring nullable

Human-readable next step. Set only when status is pending_approval; otherwise null.

metadataobject nullable

The metadata attached when this object was created, unchanged. null when none was attached. Rarely, a .created webhook can be published before the create request finishes committing, and that one event reports null; every later event and every read of the object carries the metadata.

Changes

No recorded changes to this operation across all 1 revision of this API.