Connect Facebook Page to Account

POST

https://api.synup.com/api/v4/connected-accounts/connect-facebook

This API initiates the process of connecting a new Facebook Page account to the system. The response provides a URL for the user to complete Facebook’s OAuth authentication flow.

Important Notes:

The response includes a URL that the user must visit to authenticate and connect their Facebook Page account.

The provided URL is valid for 24 hours.

When the user accesses the URL, they are redirected to Facebook’s OAuth authentication flow.

During OAuth, the user must:

Review and accept Facebook’s terms and conditions.

Grant necessary permissions for integration.

After OAuth authentication:

If successful, the user is redirected to the successUrl specified in the request.

If permissions are declined or the process fails, the user is redirected to the errorUrl.

Request

Header Params

Body Params application/json

Example

{
    "input": {
        "errorUrl": "http://www.errorurl.com",
        "successUrl": "http://www.successurl.com"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.synup.com/api/v4/connected-accounts/connect-facebook' \
--header 'Authorization: API T9V35W3xxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "input": {
        "errorUrl": "http://www.errorurl.com",
        "successUrl": "http://www.successurl.com"
    }
}'

Responses

🟢200OK

application/json

Successfully generated connection URL

Body

Example

{
    "data": {
        "bulkConnectLinkForFacebook": {
            "errors": null,
            "success": true,
            "url": "https://claim.verifymybiz.com/locations/redirect_oauth_bulk/facebook?onboarding=false&platform=local&token=bfac8e06-8d72-4810-9c50-ae7ee12a7b52"
        }
    }
}

🟠400Bad Request

Modified at 2025-07-16 11:20:40

Connect Google Profile to Account

List all connected accounts