Skip to main content
PUT
/
api
/
v2
/
public
/
linked-account
Upsert linked account
curl --request PUT \
  --url https://api.gocobalt.io/api/v2/public/linked-account \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "linked_account_id": "<string>",
  "name": "<string>",
  "your_app": {},
  "udf": {}
}'
{
    "_id": "63cabcc596d0d10508a69bdf",
    "associated_org": "63c93da0b46b7243785a1e17",
    "account_id": "12345678",
    "environment": "test",
    "name": "Mark Wood",
    "udf": [
        {
            "key_name": "some_key1",
            "key_value": "Updated Value",
            "_id": "64d5d69bfb78da0950f5e18f",
            "updatedAt": "2023-08-11T06:35:07.574Z",
            "createdAt": "2023-08-11T06:35:07.574Z"
        },
        {
            "key_name": "some_key2",
            "key_value": "some data 2",
            "_id": "64d5d69bfb78da0950f5e190",
            "updatedAt": "2023-08-11T06:35:07.574Z",
            "createdAt": "2023-08-11T06:35:07.574Z"
        },
        {
            "key_name": "some_key3",
            "key_value": "some data 3",
            "_id": "64d5d69bfb78da0950f5e191",
            "updatedAt": "2023-08-11T06:35:07.574Z",
            "createdAt": "2023-08-11T06:35:07.574Z"
        }
    ],
    "createdAt": "2023-01-20T16:09:41.700Z",
    "updatedAt": "2023-08-11T06:35:07.574Z",
    "__v": 326
}
This API updates the details of an existing linked account or creates a new one if no account exists for the provided linked account ID.

​
Request description

​
Body Parameters

​
linked_account_id
string
required
Unique customer identification id. For Eg: markwood@some_email.com
​
name
string
User name. for Eg: Mark Wood
​
your_app
object
An object containing the details of your application associated with your account.
Passing an empty your_app object without auth_credentials will throw an API Error.
It is recommended to either do not pass your_app object or pass it with auth_credentials.
​
udf
object
An object containing user-defined fields (if any) associated with the linked account.

​
Response description

  • 200
  • Error
​
_id
string
index id of the record created
​
associated_org
string
Organization Id
​
account_id
string
Linked account id
​
environment
string
Environment in which the account was created
​
name
string
Name of the linked account
​
udf
array
Initial values passed while creating the linked account. User can pass any values of primitive datatypes.
​
createdAt
date
Creation time
​
updatedAt
date
`Last update time
​
__v
integer
{
    "_id": "63cabcc596d0d10508a69bdf",
    "associated_org": "63c93da0b46b7243785a1e17",
    "account_id": "12345678",
    "environment": "test",
    "name": "Mark Wood",
    "udf": [
        {
            "key_name": "some_key1",
            "key_value": "Updated Value",
            "_id": "64d5d69bfb78da0950f5e18f",
            "updatedAt": "2023-08-11T06:35:07.574Z",
            "createdAt": "2023-08-11T06:35:07.574Z"
        },
        {
            "key_name": "some_key2",
            "key_value": "some data 2",
            "_id": "64d5d69bfb78da0950f5e190",
            "updatedAt": "2023-08-11T06:35:07.574Z",
            "createdAt": "2023-08-11T06:35:07.574Z"
        },
        {
            "key_name": "some_key3",
            "key_value": "some data 3",
            "_id": "64d5d69bfb78da0950f5e191",
            "updatedAt": "2023-08-11T06:35:07.574Z",
            "createdAt": "2023-08-11T06:35:07.574Z"
        }
    ],
    "createdAt": "2023-01-20T16:09:41.700Z",
    "updatedAt": "2023-08-11T06:35:07.574Z",
    "__v": 326
}