Push a video to Facebook

Supported Formats

json

Errors

Code Description
400 Bad Request: body has wrong syntax or unable to handle request
401 Unauthorized: auth_token omitted or authentication failed
403 Forbidden: This action cannot be performed
404 Not Found: The requested resource could not be found
406 Not Acceptable: Accept or Content-Type headers must be application/json, text/csv or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Examples

REQUEST
Content-Type: application/json
{
  "facebook_user_id": "132969177066359",
  "node_type": "page",
  "page_id": "3141592653"
}

RESPONSE
201 (Created)
{
  "node_id": "1086494448062694",
  "facebook_user_id": "132969177066359"
}

Params

Param name Description
auth_token
optional

API token needed to authorize requests
This can appear as an attribute in the body of the request or the query parameters on the URL

Validations:

  • Must be a String

id
required

The id of the video to push.

Validations:

  • Parameter has to be Integer.

facebook_user_id
required

An authenticated user’s Facebook ID.

Validations:

  • Must be a String

node_type
required

The Facebook endpoint where the video will be posted.

Validations:

  • Must be one of: wall, page.

page_id
required

A valid Facebook page id managed by the specified user.

Validations:

  • Must be a String

scheduled_publish_time
optional

Timestamp (Unix Time)
Default: Now.

Validations:

  • Parameter has to be TimeStamp.

embeddable
optional

Whether the video is embeddable. Default: true.

Validations:

  • Parameter has to be Boolean.

no_story
optional

If set to true, this will suppress feed and timeline story. Default: false.

Validations:

  • Parameter has to be Boolean.

secret
optional

If set to true, this video will not appear anywhere on Facebook and is not searchable. Default: false.

Validations:

  • Parameter has to be Boolean.

copy_description
optional

Copy video description. Default: true.

Validations:

  • Parameter has to be Boolean.