Linked Accounts | Hitchhikers

LinkedAccounts: List

Lists all linked accounts in an account.

path Parameters

accountId

required

string

query Parameters

entityIds	Array of strings When provided, only linked accounts assigned to the specified entities will be returned.
publisherIds	Array of strings When provided, only linked accounts for the specified sites will be returned.
statuses	Array of strings Items Enum: "VALID" "INVALID" Defaults to all statuses. When specified, only linked accounts with the provided statuses will be returned.
pageToken	string If a response to a previous request contained the `nextPageToken` field, pass that field's value as the `pageToken` parameter to retrieve the next page of data.
limit	integer <= 50 Default: 10 Number of results to return.
offset	integer Default: 0 Number of results to skip. Used to page through results. Cannot be used together with `pageToken`.
v required	string A date in `YYYYMMDD` format.

Responses

Response samples

200
default

Content type

application/json

{"meta": {"uuid": "4f72b877-e2d0-4de4-9324-b9cf2c03e1a0"
},
"response": {"count": 0,
"nextPageToken": "string",
"linkedAccounts": [{"id": "string",
"publisherId": "string",
"entityIds": ["string"
],
"firstName": "string",
"lastName": "string",
"email": "string",
"status": "string",
"canAssign": true
}
]
}
}

LinkedAccounts: Get

Get details for an linked account.

path Parameters

accountId required	string
linkedAccountId required	string

query Parameters

v

required

string

A date in YYYYMMDD format.

Responses

Response samples

200
default

Content type

application/json

{"meta": {"uuid": "4f72b877-e2d0-4de4-9324-b9cf2c03e1a0",
"errors": [ ]
},
"response": {"id": 3955191,
"publisherId": "GOOGLEMYBUSINESS",
"entityIds": ["3492378"
],
"firstName": "John",
"lastName": "Doe",
"email": "johndoe@email.com",
"status": "VALID",
"canAssign": true
}
}

LinkedAccounts: Assign

Copy an eligible Linked Account from the top-level parent account to a subaccount. Optionally assign the Linked Account to an entity in the subaccount.

This functionality is only available for certain Yext accounts. Please reach out to your Yext representative for more information.

path Parameters

accountId required	string
linkedAccountId required	string

query Parameters

v

required

string

A date in YYYYMMDD format.

Request Body schema: application/json

destinationAccountId required	string The destination account ID that the linked account will be copied to.
entityIds	Array of strings The IDs of the entities that the linked account will be assigned to. The entity IDs must belong to the destination account ID. entityIds is required in order to copy and assign the Linked Account to the destination account ID.

Responses

Request samples

Payload

Content type

application/json

{"destinationAccountId": "string",
"entityIds": ["string"
]
}

Response samples

200
default

Content type

application/json

{"meta": {"uuid": "4f72b877-e2d0-4de4-9324-b9cf2c03e1a0",
"errors": [ ]
},
"response": {"linkedAccountId": 512353
}
}