Add Account

Use the Add Account endpoint to add a secondary account to an existing customer account. The account types that may be added include savings, overdraft, account with no card, virtual card, or personalized card.

Consult the Adding an Account procedure for instructions on using this endpoint. Also see Create Account vs Add Account in the About Accounts guide.

Status codes

See Global Response Statuses for status codes that are common across endpoints.

The table below lists status codes that apply to this specific endpoint.

Status codeDescription
456-01Product not supported. You cannot add an account with this prodId using this endpoint. Check product settings. Check SECP on the primary product.
456-03Customer already has this product. Your product settings (ASPRD) do not permit a customer to have multiple accounts with the same productId. Notify the customer that they cannot have multiple instances of this product.
456-04Cannot add this product as a savings account for this card. Retry with a savings account that is valid for the primary account, check SAVPI or SAVPL for the primary account, or notify the customer that this product cannot be added.
456-05The primary account is marked ineligible for this product. Your product settings do not permit the primary account to have this product as a secondary account. Retry with a valid primary account, notify the customer that this account is ineligible, or verify that your product settings (SECP) are correct.
456-06Invalid real-time funding account. Input a valid 12-digit PRN of an RTF funding account.
456-07Maximum number of secondary accounts exceeded. Product settings do not permit this many secondary accounts per primary account. Set SECLM on the secondary account to a higher number.
456-08Secondary accounts cannot be added to secondary accounts.
456-09Primary account is invalid. The account number in accountNo cannot be an instant-issue card.
Form Data
string
required

Web service username, as provided by Galileo.
Pattern: Max 50 characters
Example: "AbC123-9999"

string
required

Web service password, as provided by Galileo.
Pattern: Max 15 characters
Example: "4sb62fh6w4h7w34g"

int32
required

Galileo-issued provider identifier.
Pattern: Max 10 digits
Example: 9999

string
required
1 to 60

A unique provider-generated ID to identify this API call. A UUID is preferred.
Pattern: 60 characters or less
Example: "9845dk-39fdk3fj3-4483483478"

string
required

The PAN or PRN of the primary account to associate with this secondary account.
Pattern: PAN or PRN
Example: "112541764367"

int32
required
0 to 100000000

Galileo-generated identifier for a product. If this ID is for a business product then businessName is required.
Pattern: Integer
Example: 501

string | null
≤ 20

Unique location identifier (location) as returned by the Create Location endpoint. This value is also returned by the Get Locations endpoint depending on the value of locationType when the location was created:

  • 0 or 2 — Returned in the location_id field
  • 1 — Returned in the provider_specified_id field

Pattern: Integer if locationType: 0 or locationType: 2; max 15 characters if locationType: 1
Example: "a455-3483"

int32 | null
enum

Type of ID in location:

  • 0 — Galileo location ID
  • 1 — Partner location ID
  • 2 — Don't validate

Pattern: Integer
Example: 1

Allowed:
int32 | null
enum

Specifies whether the secondary account will share the balance of the primary account.

  • 0 — Do not share the balance
  • 1 — Share the balance

Pattern: One digit
Example: 1

Allowed:
string | null

PRN of the RTF funding account. Required if prodId is an RTF spending product.
Pattern: 12-digit numeric string
Example: "143101204201"

Headers
string
enum
Defaults to json

Use this header instead of the standard accept header to specify the response format.

Allowed:
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Response

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/xml

© Galileo Financial Technologies, LLC 2026    Privacy Disclosure

All documentation, including but not limited to text, graphics, images, and any other content, are the exclusive property of Galileo Financial Technologies, LLC and are protected by copyright laws. These materials may not be reproduced, distributed, transmitted, displayed, or otherwise used without the prior written permission of Galileo Financial Technologies, LLC. Any unauthorized use or reproduction of these materials are expressly prohibited.