Skip to main content
POST
/
api
/
v1
/
eoa-accounts
Add a new account address for authentication
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({address: '0x1234567890abcdef1234567890abcdef12345678'})
};

fetch('https://api.gnosispay.com/api/v1/eoa-accounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "id": "clp3j1f9a0000a1cdh6ezx2qv",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "userId": "user_123",
  "createdAt": "2025-01-27T00:00:00Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
address
string

The Ethereum address of the new externally owned account.

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x1234567890abcdef1234567890abcdef12345678"

Response

Successfully created EOA account.

​
id
string
Example:

"clp3j1f9a0000a1cdh6ezx2qv"

​
address
string
Example:

"0x1234567890abcdef1234567890abcdef12345678"

​
userId
string
Example:

"user_123"

​
createdAt
string<date-time>
Example:

"2025-01-27T00:00:00Z"