POST
/
users
/
{user_id}
/
accounts
cURL
curl --request POST \
  --url http://localhost:8080/users/{user_id}/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_provider_id": "<string>",
  "account_type": "s_a_v_i_n_g_s",
  "provider_account_id": "<string>",
  "customer_id": "<string>"
}
'
{
  "account_provider_id": "<string>",
  "account_provider_name": "<string>",
  "account_provider_status": "active",
  "account_type": "s_a_v_i_n_g_s",
  "created_at": "<string>",
  "id": "<string>",
  "last_modified_at": "<string>",
  "provider_account_id": "<string>",
  "status": "active",
  "user_id": "<string>",
  "customer_id": "<string>"
}

Authorizations

Authorization
string
header
required

JWT access token. Obtain from /auth/otp/verify endpoint.

Path Parameters

user_id
string
required

User ID

Body

application/json
account_provider_id
string
required
account_type
enum<string>
required

Type of financial or health account.

Available options:
s_a_v_i_n_g_s,
h_s_a,
e_d_u_c_a_t_i_o_n
provider_account_id
string
required
customer_id
string | null

Response

Account created

account_provider_id
string
required
account_provider_name
string
required
account_provider_status
enum<string>
required

Account provider lifecycle status.

Available options:
active,
inactive
account_type
enum<string>
required

Type of financial or health account.

Available options:
s_a_v_i_n_g_s,
h_s_a,
e_d_u_c_a_t_i_o_n
created_at
string
required
id
string
required
last_modified_at
string
required
provider_account_id
string
required
status
enum<string>
required

Account lifecycle status.

Available options:
active,
inactive,
pending
user_id
string
required
customer_id
string | null