Facebook

Connect your Facebook Page to schedule and publish posts through Cue.

Overview

Facebook is a social media platform where you can share updates, photos, and videos with your audience. Cue integrates with the Facebook Graph API to publish content to Pages you manage.

Important: Cue supports publishing to Facebook Pages only. Personal profiles are not supported by the Facebook API for third-party apps.

Sign up for a Facebook account at facebook.com.

Authentication

Facebook uses OAuth 2.0 for secure authentication. You'll need to be an admin or editor of the Facebook Page you want to connect.

Prerequisites

Before connecting to Cue:

1. Create a Facebook Page (if you don't have one)
2. Ensure you have admin or editor role on the Page

Creating a Facebook Page

1. Go to facebook.com/pages/create
2. Choose a Page type (Business, Brand, Community, etc.)
3. Enter your Page name and category
4. Add profile and cover images
5. Complete your Page setup

Connecting Your Account

1. Go to Profiles in your Cue dashboard
2. Click Connect Account on a profile
3. Select Facebook
4. You'll be redirected to Facebook to authorize access
5. Select the Page(s) you want to connect to Cue
6. Grant Cue permission to post on your behalf
7. You'll be redirected back to Cue automatically

Your credentials are never shared with Cue.

Permissions

Cue requests the following permissions:

• pages_manage_posts - Create and publish posts to Pages
• pages_read_engagement - Read Page engagement data
• pages_show_list - View Pages you manage

Disconnecting

To disconnect your Facebook Page, go to your profile and click Disconnect next to the Facebook connection. This revokes Cue's access to your Page.

You can also revoke access from Facebook Settings under Business Integrations.

Content Limits

Facebook enforces the following limits on Page posts:

Cue automatically validates your content before publishing to prevent errors.

Publishing a Post

curl -X POST https://api.oncue.so/v1/posts \
  -H "Authorization: Bearer cue_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prf_abc123",
    "platforms": {
      "sac_facebook1": {
        "items": [{ "content": "Exciting news from our team!" }]
      }
    },
    "publishNow": true
  }'

const response = await fetch("https://api.oncue.so/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer cue_sk_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    profileId: "prf_abc123",
    platforms: {
      sac_facebook1: {
        items: [{ content: "Exciting news from our team!" }],
      },
    },
    publishNow: true,
  }),
});

Schedule for Later

curl -X POST https://api.oncue.so/v1/posts \
  -H "Authorization: Bearer cue_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prf_abc123",
    "platforms": {
      "sac_facebook1": {
        "items": [{ "content": "Scheduled Facebook Page post" }]
      }
    },
    "scheduledAt": "2024-01-20T09:00:00-05:00"
  }'

const response = await fetch("https://api.oncue.so/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer cue_sk_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    profileId: "prf_abc123",
    platforms: {
      sac_facebook1: {
        items: [{ content: "Scheduled Facebook Page post" }],
      },
    },
    scheduledAt: "2024-01-20T09:00:00-05:00",
  }),
});

Response

{
  "data": {
    "id": "pst_xyz789",
    "profileId": "prf_abc123",
    "content": "Exciting news from our team!",
    "status": "queued",
    "scheduledAt": null,
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  },
  "message": "Post queued for publishing to 1 platform(s)"
}

Error Handling

Facebook API errors are translated into user-friendly messages:

Common Issues

"Reconnect required" error

• Your access token has expired or been revoked
• Go to your profile and reconnect your Facebook Page

"No Pages found" error

• You may not have admin/editor role on any Pages
• Create a Facebook Page or request access to an existing one

"Permission denied" error

• Required permissions were not granted during authorization
• Reconnect and ensure you approve all requested permissions

"Page not published" error

• Your Facebook Page may be unpublished
• Check your Page settings on Facebook

Troubleshooting

Connection Issues

"No Pages available to connect"

• Ensure you have admin or editor role on at least one Page
• Create a new Page if needed
• Check that you selected Pages during OAuth authorization

Cannot redirect to Facebook during OAuth

• Check your internet connection
• Try using a different browser
• Disable browser extensions that might block redirects

"Access denied" after authorization

• Ensure you selected at least one Page to connect
• Approve all requested permissions
• Check if your Facebook account has any restrictions

Publishing Issues

Posts not appearing on Page

• Check if your post is still in "queued" status
• Wait a few minutes - publishing may take time
• Check the post's platform status for error details

Link preview not showing

• Facebook needs time to generate link previews
• Verify the linked website is accessible
• Check that the website has proper Open Graph meta tags

Images not appearing

• Verify image URLs are publicly accessible
• Check file size is under 10 MB
• Ensure image format is supported (JPEG, PNG, GIF)

Best Practices

Content Guidelines

• Use eye-catching visuals to increase engagement
• Write compelling first sentences (preview text)
• Include clear calls to action
• Ask questions to encourage comments

Timing

• Post when your audience is most active
• Use Facebook Page Insights for optimal times
• Maintain consistent posting schedule

Engagement

• Respond to comments promptly
• Use Facebook's built-in scheduling for time-sensitive content
• Monitor Page performance through Insights

Further Reading

• Facebook Pages Help
• Facebook Business Suite
• Meta Business Help Center