---
title: "Connect a location with a listing of a connected account"
method: POST
path: "/connected-accounts/connect-listing"
tags: ["Connected Accounts"]
---

# Connect a location with a listing of a connected account

`POST /connected-accounts/connect-listing`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/connected-accounts/connect-listing`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/connected-accounts/connect-listing/post.ts> (a function with typed inputs; its response is checked against the schema)

This API links a location in your account with a listing from a connected Google My Business or Facebook Page account.

**Required Fields:**
- locationId – Base64-encoded unique identifier of the location.
- connectedAccountListingId – The ID of the listing, retrieved from the Fetch Listings API.
- connectedAccountId – The ID of the connected account managing the listing.

**Behavior:**
- Establishes a direct connection between the location and the listing.
- Enables the system to sync and manage the listing’s data.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- ConnectListingRequest
  - `input` object, required
    - `locationId` string, required: Base64 encoded location ID
    - `connectedAccountId` string, uuid, required: ID of the connected account
    - `connectedAccountListingId` string, required: ID of the listing from the fetch listings API response. This is typically a base64 encoded string.

## Response `200`

Connection process completed

- ConnectListingResponse
  - `data` object
    - `connectListing` object
      - `success` boolean, required: Indicates if the connection was successful
      - `message` string, nullable: Error message if the connection failed. Returns null on successful connection.

## Other responses

- `400`: Invalid request - Malformed base64 string or invalid IDs
- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - Insufficient permissions
- `404`: Not Found - Location or listing not found

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)