Skip to content
PostFlow

Reply to a conversation

POST
/inbox/messages/{id}/reply
curl --request POST \
  --url https://postflow.biz.id/api/v1/inbox/messages/example/reply \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "text": "example" }'

Sends a message on the platform. Meta only allows replies within 24 hours of the person’s last message (replyUntil). You can’t start conversations.

MCP tool: reply_to_conversation.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string

Conversation id

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
text
required
string
>= 1 characters <= 1000 characters

Example generated

{
  "text": "example"
}

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json
object
id
required
string
account
required
object
id
required
string
platform
required
string
Allowed values: facebook instagram tiktok threads bluesky youtube telegram
name
required
string
username
required
Any of:
string
avatarUrl
required
Any of:
string
participant
required
object
id
required
string
name
required
Any of:
string
username
required
Any of:
string
lastText
required
string
lastMessageAt
required
string format: date-time
status
required
string
Allowed values: new done
replyUntil
required
Any of:

Replies are allowed until then: 24 hours after their last message.

string format: date-time

Example 

{
  "account": {
    "platform": "facebook"
  },
  "status": "new"
}

400

Section titled “400”

Validation failed. details lists what to fix.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL
message
required

A sentence you can show to a person.

string
details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example 

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

401

Section titled “401”

Missing, invalid, expired or deleted key or token.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL
message
required

A sentence you can show to a person.

string
details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example 

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

402

Section titled “402”

Subscription inactive or plan limit reached.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL
message
required

A sentence you can show to a person.

string
details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example 

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

403

Section titled “403”

Not allowed: a read-only key, the owner’s approval, or an owner-only action.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL
message
required

A sentence you can show to a person.

string
details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example 

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

404

Section titled “404”

Not found in this workspace.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL
message
required

A sentence you can show to a person.

string
details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example 

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

409

Section titled “409”

Conflict, e.g. the post is publishing right now, or the platform refused the action.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL
message
required

A sentence you can show to a person.

string
details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example 

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

429

Section titled “429”

More than 120 requests in a minute with this key.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL
message
required

A sentence you can show to a person.

string
details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example 

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}
© 2026 PostFlow