1. Connected Accounts
  • Getting Started
  • Locations
    • Location Attributes
      MARKDOWN
    • Photo specifications for your business location
      MARKDOWN
    • Star and Unstar Photos
      MARKDOWN
    • Create a new business location
      POST
    • Update business location
      POST
    • List all locations
      GET
    • List particular locations
      GET
    • Search locations
      GET
    • Get locations by store codes
      GET
    • Upload Photos to a Location
      POST
    • Check Bulk Photo Upload Status
      GET
    • Star/Unstar Location Photos
      POST
    • Delete Location Photos
      POST
    • Archive multiple locations
      POST
    • Cancel scheduled location archival
      POST
    • Activate archived locations
      POST
    • List Active Subscriptions
      GET
    • Get a list of supported countries and their states
      GET
    • Get SubCategories and AdditionalCategories
      GET
    • Get Site Details for Your Plan
      GET
  • Organizing locations
    • Organizing locations
    • Create a new folder
    • List all folders
    • List all folders under an account in hierarchical structure
    • Get details of a folder
    • Rename a folder
    • Add locations to a folder
    • Remove locations from a folder
    • Delete a folder
    • List locations under a folder
    • List all tags
    • List locations by tags
    • Add location to a tag
    • Remove location from a tag
  • User Management
    • User Attributes
    • Create User with Role
    • List Users
    • List Users by ID
    • Add Locations to User
    • Add User and folder
    • List User Roles
    • Add folders to user
    • List User Resources
    • Update a User
    • Remove Folders for User
    • Remove Locations for User
  • Grid Rank
    • Local Rank Grid
    • Create Rank Grid Report
    • Fetch All Grid Reports for Location
    • Fetch Rank Grid Report By ID
  • Review Campaigns
    • Review Campaign Info Attributes
    • Create a review campaign
    • Add customers to a review campaign
    • List review campaigns
    • List review campaign customers
  • Listings
    • Listings
    • Listing Status Webhooks
    • Get premium listings
    • Get voice listings for a location
    • Get duplicate listings for a location
    • Get all duplicate listings for an account
    • Mark listings as duplicates
    • Mark listings as not duplicates
    • Get AI listings
  • Connected Accounts
    • Connected Accounts
      MARKDOWN
    • Connect Google Profile to Account
      POST
    • Connect Facebook Page to Account
      POST
    • List all connected accounts
      GET
    • List folders under a Google account
      GET
    • Create GMB Listing
      POST
    • Disconnect GMB Profile
      POST
    • Disconnect Facebook Account
      POST
    • Fetch Connected Account Details
      GET
    • Trigger New Matches
      POST
    • List Connection Suggestions
      GET
    • Fetch Connected Account Listings
      POST
    • Confirm Connected Account Matches
      POST
    • Connect a location with a listing of a connected account
      POST
    • Disconnect Location from Listing
      POST
  • Rankings
    • Rankings Analytics Attributes
    • Add keywords
    • List Keywords
    • Get keywords performance
    • Archive a keyword
    • Get Rollup Keyword Performance
    • Get Rankings Distribution By Time
  • Profile Analytics
    • Profile Analytics
    • Get Bing Analytics
    • Get Facebook Page Analytics
    • Get Google My Business Analytics
  • Reviews
    • Reviews
    • Review Sources
      • Get a list of interaction sources for location
      • Get a list of interaction sources for account
      • Add / Edit interaction source
    • Fetch all interactions
    • List Interactions by IDs
    • Respond to an Interaction
    • Edit Response for Interaction
    • Archive Response for Interaction
    • Get Interaction Analytics
    • Add Review Widget
    • Edit Review Widget
  • Automations
    • Temporary Close Location with a reopening date
  • Error Codes
    • ERROR CODES
  1. Connected Accounts

Connected Accounts

MARKDOWN
https://api.synup.com/api/v4

Overview#

This document provides an overview of the API endpoints available for managing connected accounts. These endpoints allow you to connect and manage their Google Business Profile and Facebook profiles.
What Are Connected Accounts?
A connected account is a user account linked to Google My Business or Facebook Pages, allowing seamless management of business listings across these platforms.
Key Capabilities:
Easily link or unlink your Google My Business and Facebook Page profiles.
Associate locations with Google and Facebook listings to publish information, fetch reviews, and more.
Publish media and posts directly to the connected profiles.
Retrieve detailed insights and performance metrics.

API Endpoints#

Connect an Account#

Use this API to establish a new connection between a Google My Business or Facebook Page account and the system. Once connected, the system can manage listings, fetch reviews, and synchronize data.
Google My Business: Connect a new user account for Google My Business profiles.
Facebook Page: Connect a new user account for Facebook Page profiles.

Disconnect a Connected Account#

Use this API to remove an existing Google My Business or Facebook Page connection. This will stop syncing and managing listings associated with the disconnected account.
Google My Business: Disconnect a connected account for Google My Business profiles.
Facebook Page: Disconnect a connected account for Facebook Page profiles.

List All Connected Accounts#

Use this API to retrieve a list of all connected accounts linked to a user’s profile. The response can be filtered by:
Publisher type (Google, Facebook, etc.)
Connection status (active, expired, or disconnected)

Fetch Details of a Connected Account#

Get detailed information about a specific connected account, including connection status and any connectivity issues.

Trigger New Matches#

Use this API to automatically fetch all locations from the connected Google My Business or Facebook Page profile and attempt to match them with existing locations in the system.

List Connection Suggestions#

Use this API Retrieve recommended connections for locations that have not yet been linked to a listing. The system analyzes available data to suggest appropriate matches.

Fetch Listings of a Connected Account#

Use this API to retrieve all business listings associated with a Google My Business or Facebook Page account. Results can be filtered by location details for better organization.

Confirm Matches for a Connected Account#

Use this API to confirm and finalize the matches suggested by the List Connection Suggestions endpoint, officially linking locations to their corresponding listings.

Connect a Location with a Listing#

Use this API to establish a direct connection between a location and a listing from a connected account. This allows the system to manage the listing, ensuring business details stay updated.

Disconnect a Connected Location from a Listing#

Use this API to remove the connection between a location and a listing on Google My Business or Facebook. This prevents further updates from being pushed to the listing.
To fetch a Facebook Page's details, you must have the necessary permissions and roles:
User Role Requirements:
Admin or Moderator: The user must be an admin or moderator of the Page.
Page Information Requirements:
Address Presence: The Page must have a physical address listed.
Modified at 2025-02-21 11:04:15
Previous
Get AI listings
Next
Connect Google Profile to Account
Built with