curl --request POST \
--url https://docurise.io/api/preview/instagram/rules \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"commentReply": {
"variants": [
"Sent you a DM!"
]
},
"dm": {
"message": "Here is the guide you asked for"
}
}
'{
"id": "7f1c0f7e-3c5e-4b1a-9d34-2f0a5b6c8d90",
"url": "https://docurise.io/dashboard/instagram/rules/7f1c0f7e-3c5e-4b1a-9d34-2f0a5b6c8d90",
"status": "waiting_for_post",
"type": "standard",
"target": {
"type": "next_post"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "NEXT_POST_RULE_EXISTS",
"message": "This account already has a next-post rule. Delete it or edit it in the dashboard",
"retryable": false,
"details": {
"ruleId": "7f1c0f7e-3c5e-4b1a-9d34-2f0a5b6c8d90"
}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}Create an Instagram rule
Create the next-post DM automation rule, armed or paused
curl --request POST \
--url https://docurise.io/api/preview/instagram/rules \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"commentReply": {
"variants": [
"Sent you a DM!"
]
},
"dm": {
"message": "Here is the guide you asked for"
}
}
'{
"id": "7f1c0f7e-3c5e-4b1a-9d34-2f0a5b6c8d90",
"url": "https://docurise.io/dashboard/instagram/rules/7f1c0f7e-3c5e-4b1a-9d34-2f0a5b6c8d90",
"status": "waiting_for_post",
"type": "standard",
"target": {
"type": "next_post"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "NEXT_POST_RULE_EXISTS",
"message": "This account already has a next-post rule. Delete it or edit it in the dashboard",
"retryable": false,
"details": {
"ruleId": "7f1c0f7e-3c5e-4b1a-9d34-2f0a5b6c8d90"
}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"details": {}
}
}Authorizations
A key generated from Settings → Developers, sent as
Authorization: Bearer dr_live_<12 hex chars>_<64 hex chars>. Keys
carry explicit scopes — each endpoint states the one it requires.
The full key is shown exactly once at generation time and cannot be
retrieved again; only the keyId prefix is shown afterward. A
revoked key fails auth on its very next request.
Headers
A unique client-generated string (≤ 255 characters) identifying this create attempt. See "Idempotency" above.
255Body
Public reply DocuRise posts under the matching comment; one variant is
picked at random per comment. Required — send { "enabled": false } to
reply to nobody publicly.
Show child attributes
Show child attributes
The main DM the commenter receives.
Show child attributes
Show child attributes
active (the default) arms the rule, so it waits for the next post.
paused saves it paused: nothing is sent until you resume it with
PATCH and { "status": "active" }. Cannot be combined with
schedule.batchSendAt (422 BATCH_RULE_NOT_PAUSABLE).
active, paused What the rule applies to. Optional; only the account's next new post is supported today, so leaving it out is the same as { "type": "next_post" }.
Show child attributes
Show child attributes
Rule type. Optional. Only standard (keyword comment → DM) can be created through the API today.
standard A comment triggers the rule when it contains any keyword — matched as a
case-insensitive substring, so guide also matches "Guide please!". Empty
means every comment triggers it; if a post has both a keyword rule and an
all-comments rule, the keyword rule wins when it matches.
201 - 50The first DM, a message with one tap-to-continue button. The
commenter's tap opens Instagram's messaging window and releases the
main DM. When enabled is false the main DM is sent directly as a
private reply instead. Blank message / buttonText use
DocuRise's default wording.
Show child attributes
Show child attributes
Optional timing. Either an operating window (startAt / endAt) or
a single batch send (batchSendAt), never both. Omit for "always on".
For a next-post rule the window is applied when the rule activates on
the new post; a window that has already ended by then is dropped and
the rule simply goes live.
Show child attributes
Show child attributes
Language of DocuRise's default wording (greeting and button text left blank). Defaults to the account's language.
en, ko Response
Rule created. Its status is waiting_for_post (it waits for the next post), or paused if you asked for that.
The new rule's id.
Link to the rule in the dashboard editor.
waiting_for_post for an armed rule (the default), paused when you created it with status: paused.
waiting_for_post, paused The rule type: standard for a rule created through the API.
What the rule applies to.
Show child attributes
Show child attributes