Meta Schedule

Meta Schedule

Certified

Schedule a Facebook Page post

Creates a Page feed post with a future publish time between 10 minutes and 30 days from now.

yaml
type: io.kestra.plugin.meta.facebook.posts.Schedule

Schedule a post for tomorrow

yaml
id: facebook_schedule_post
namespace: company.team

tasks:
  - id: schedule_post
    type: io.kestra.plugin.meta.facebook.posts.Schedule
    pageId: "{{ secret('FACEBOOK_PAGE_ID') }}"
    accessToken: "{{ secret('FACEBOOK_ACCESS_TOKEN') }}"
    message: "This post is scheduled for tomorrow!"
    scheduledPublishTime: "{{ now() | dateAdd(1, 'DAYS') | date('yyyy-MM-dd HH:mm:ss') }}"

Schedule a post with Unix timestamp

yaml
id: schedule_facebook_post
namespace: company.team

tasks:
  - id: schedule_unix_post
    type: io.kestra.plugin.meta.facebook.posts.Schedule
    pageId: "{{ secret('FACEBOOK_PAGE_ID') }}"
    accessToken: "{{ secret('FACEBOOK_ACCESS_TOKEN') }}"
    message: "Scheduled post with timestamp"
    scheduledPublishTime: "1735689600"
    link: "https://example.com"
Properties

Access Token

Page access token with permissions such as pages_manage_posts and pages_read_engagement.

Post message

Text content that will be published at the scheduled time.

Facebook Page ID

ID of the Page the task operates on; must match the access token scope.

Scheduled publish time

Publish time as Unix timestamp or ISO-8601 string (e.g., 2025-10-26T10: 30: 00Z); must be 10 minutes to 30 days in the future.

Defaulthttps://graph.facebook.com

Base API URL

Base Graph API URL. Defaults to https://graph.facebook.com.

Defaultv24.0

API Version

Facebook Graph API version to call. Defaults to v24.0.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150