Skip to main content
POST
/
accountOwners
curl --request POST \
     --url https://api.tryaqueduct.com/v1/accountOwners \
     --header 'Accept: application/json' \
     --header 'Authorization: null' \
     --header 'Content-Type: application/json'

{
  "id": "owner_01FSSVRVGQ7GGB13815DE3F518",
  "name": "Bobby Buyer",
  "email": "[email protected]",
  "phoneNumber": "555-555-5555",
  "address": {
    "addressLine1": "123 Cherry Lane",
    "addressLine2": "Apt 456",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94103",
    "country": "USA"
  },
  "tags": [
    "customer",
    "payout-target"
  ],
  "primaryAccount": {
    "id": "acct_01FSSVRVGQ7GGB13815DE3F518",
    "currentBalance": 123,
    "currency": "USD",
    "isCredits": true,
    "tag": "marketplace"
  },
  "stripeCustomerId": "cus_234827394"
}
curl --request POST \
     --url https://api.tryaqueduct.com/v1/accountOwners \
     --header 'Accept: application/json' \
     --header 'Authorization: null' \
     --header 'Content-Type: application/json'

Authorizations

​
Authorization
string
header
required

Body

application/json
​
name
string

Name of the account owner (person or organization)

Example:

"Bobby Buyer"

​
email
string

Contact email address - usually the billing email of the organization

Example:

"[email protected]"

​
phoneNumber
string
Example:

"555-555-5555"

​
address
object

A physical address associated with an account owner

​
tags
string[]

tags to associate with this account owner

Example:
["customer", "payout-target"]
​
accountType
string

AccountsReceivable (for customers), PayoutAccount. Can also be CreditsGivenAccount, CreditsReceivedAccount, CashAccount, ProcessingFeesAccount, RevenueAccount, but generally these are not created via API

​
stripeCustomerId
string

The Stripe Customer Id associated with this account owner. Will be used for all Stripe payments associated with the account owner.

Example:

"cus_234827394"

Response

201 - application/json

Account is created successfully

Person or organization that owns an Account

​
id
string

A unique identifier for the object

Example:

"owner_01FSSVRVGQ7GGB13815DE3F518"

​
name
string

Name of the account owner (person or organization)

Example:

"Bobby Buyer"

​
email
string

Contact email address - usually the billing email of the organization

Example:

"[email protected]"

​
phoneNumber
string
Example:

"555-555-5555"

​
address
object

A physical address associated with an account owner

​
tags
string[]

Tags associated with this account owner

Example:
["customer", "payout-target"]
​
primaryAccount
object

The default ledger account for this account owner - as opposed to additional accounts for e.g. credits

​
stripeCustomerId
string

The Stripe Customer Id associated with this account owner. Will be used for all Stripe payments associated with the account owner.

Example:

"cus_234827394"