Journey tools

{
  "name": "fanaura.create_journey",
  "arguments": {
    "destination_url": "https://example.com/guide",
    "keyword": "GUIDE"
  }
}

{
  "success": true,
  "live": true,
  "message": "Journey is live at https://fanaura.me/yourname/free-guide.",
  "recap": {
    "name": "Free Guide",
    "keyword": "GUIDE",
    "destination_url": "https://example.com/guide",
    "public_url": "https://fanaura.me/yourname/free-guide",
    "triggers": ["Instagram comments", "Instagram DMs"],
    "followers_only": false,
    "capture": "Automatic: asks one missing contact detail per visit (phone, then email, then name)",
    "public_comment_replies": 10,
    "sample_public_reply": "Sent it to your DMs",
    "repeat_visitors_get_link_again": true
  },
  "iphone_deep_link": "fanaura://journeys/2f6c...",
  "web_builder_url": "https://app.fanaura.com/automations/2f6c..."
}

{
  "success": true,
  "live": false,
  "message": "Connect Instagram before this keyword can go live.",
  "structuredContent": {
    "blockers": [
      { "code": "instagram_not_connected", "message": "Connect Instagram before this keyword can go live." }
    ]
  }
}

{
  "name": "fanaura.create_journey",
  "arguments": {
    "destination_url": "https://example.com/guide",
    "keyword": "GUIDE"
  }
}

{
  "success": true,
  "live": true,
  "message": "Journey is live at https://fanaura.me/yourname/free-guide.",
  "recap": {
    "name": "Free Guide",
    "keyword": "GUIDE",
    "destination_url": "https://example.com/guide",
    "public_url": "https://fanaura.me/yourname/free-guide",
    "triggers": ["Instagram comments", "Instagram DMs"],
    "followers_only": false,
    "capture": "Automatic: asks one missing contact detail per visit (phone, then email, then name)",
    "public_comment_replies": 10,
    "sample_public_reply": "Sent it to your DMs",
    "repeat_visitors_get_link_again": true
  },
  "iphone_deep_link": "fanaura://journeys/2f6c...",
  "web_builder_url": "https://app.fanaura.com/automations/2f6c..."
}

{
  "success": true,
  "live": false,
  "message": "Connect Instagram before this keyword can go live.",
  "structuredContent": {
    "blockers": [
      { "code": "instagram_not_connected", "message": "Connect Instagram before this keyword can go live." }
    ]
  }
}

A journey is one link with one job: someone comments or DMs your keyword, Fanaura sends your link, can ask for a contact detail, and sends them to your page. These tools build and manage journeys.

Every tool that takes journey_id expects the UUID returned by start_journey, create_journey, or list_journeys.

Create and publish in one call

Create journey

fanaura.create_journey builds a journey from a destination URL and publishes it in the same call unless publish is false. Fanaura fills in anything you left out: the name, the keyword, up to ten public comment replies, automatic contact capture, and every connected Instagram, text, and email trigger. It returns live, a recap of those settings, and public_url when the journey is live. The journey is saved as a draft, with the reason in blockers, when Instagram is not connected, the keyword is live on another journey, the public name is not claimed, or membership is inactive. An invalid URL creates nothing. A repeat with the same idempotency_key returns the first result and creates nothing new.

string

required

The full public https:// page people land on, such as a song, an episode, a booking page, or a download.

string

One word of up to 32 letters or numbers. Saved in capitals. When omitted, Fanaura suggests one from the link and falls back to LINK.

string

The journey name. When omitted, Fanaura names it from the page. The public link is built from the name.

string[]

Public reply lines posted under the comment. Up to 10 are kept. Fanaura writes the rest so there are always up to 10 versions.

string

The DM text that comes with the link. When omitted, Fanaura uses its default greeting.

boolean

default:"false"

Send the link only to people who follow the account on Instagram.

boolean

default:"true"

Send the link again when the same person comments the keyword again.

boolean

default:"true"

Pass false only when the user asks for a draft.

string

Any unique string. A retry with the same key returns the first result instead of building a second journey.

boolean

required

true when the journey is published.

string

required

“Journey is live at” plus the public link, or the reason it stayed a draft.

object

What Fanaura chose: name, keyword, destination_url, public_url, share_url, triggers, followers_only, capture, public_comment_replies, sample_public_reply, and repeat_visitors_get_link_again.

object

Show properties

object

The full saved journey, including the draft and revision.

object[]

Each item has a code and a message. Empty when the journey is live.

string

The public link, such as fanaura.me/yourname/free-guide.

The short share link, or null.

{
  "name": "fanaura.create_journey",
  "arguments": {
    "destination_url": "https://example.com/guide",
    "keyword": "GUIDE"
  }
}

{
  "success": true,
  "live": true,
  "message": "Journey is live at https://fanaura.me/yourname/free-guide.",
  "recap": {
    "name": "Free Guide",
    "keyword": "GUIDE",
    "destination_url": "https://example.com/guide",
    "public_url": "https://fanaura.me/yourname/free-guide",
    "triggers": ["Instagram comments", "Instagram DMs"],
    "followers_only": false,
    "capture": "Automatic: asks one missing contact detail per visit (phone, then email, then name)",
    "public_comment_replies": 10,
    "sample_public_reply": "Sent it to your DMs",
    "repeat_visitors_get_link_again": true
  },
  "iphone_deep_link": "fanaura://journeys/2f6c...",
  "web_builder_url": "https://app.fanaura.com/automations/2f6c..."
}

{
  "success": true,
  "live": false,
  "message": "Connect Instagram before this keyword can go live.",
  "structuredContent": {
    "blockers": [
      { "code": "instagram_not_connected", "message": "Connect Instagram before this keyword can go live." }
    ]
  }
}

Blocker codes

Code	Meaning
`invalid_destination`	The link is not a full public URL, or the keyword is not allowed. Nothing is saved.
`instagram_not_connected`	No ready Instagram connection. Saved as a draft.
`keyword_taken`	Another journey uses this keyword. The message names it. Saved as a draft.
`membership_inactive`	No active membership. Saved as a draft.
`name_not_claimed`	The public name is not claimed. Saved as a draft.
`publish_failed`	Publishing failed for another reason. Saved as a draft.

true to require a follow. false to send to anyone.

Each set_ tool returns the updated journey_draft. On a live journey, the change waits in the draft until publish_journey runs.

Check and publish

Check destination link

fanaura.check_link answers yes or no for a destination. Read only.

string

required

Journey UUID.

string

Optional URL to check instead of the saved one.

Validate publish checklist

fanaura.validate_publish lists what is missing before publish. It never publishes.

string

required

Journey UUID.

Publish journey

fanaura.publish_journey reserves the public link from the journey name and publishes the current draft. It returns public_url, share_url, and a recap of the live settings. When the live version already matches the draft, it changes nothing and says so. It fails when the checklist is incomplete, the public name is not claimed, or the draft changed after expected_revision.

string

required

Journey UUID.

boolean

required

Must be true. This records that you asked for the journey to go live. Publishing is refused when it is false or missing.

number

Optional. The revision from the latest draft. Prevents publishing over a newer change made elsewhere.

string

“Journey is live at” plus the link, or “This journey is already live.” when nothing changed.

object

journey, public_url, and share_url.

object

The same recap as create_journey.

On failure, error reads Field <name>: <what to fix> and field names the input. Fields include user_confirmed, destination_url, keyword, replies, name, slug, expected_revision, and journey_id.

Read journeys

List journeys

fanaura.list_journeys answers what is live, what keyword a journey uses, and where it sends people.

boolean

default:"false"

true to list archived journeys.

string

Search by name, keyword, or destination.

Get journey

fanaura.get_journey returns one draft or live journey.

string

required

Journey UUID.

Overview

Connect your assistant

Guides

Tool reference

Security and data

Create and publish in one call

Create journey

Blocker codes

Build step by step

Start journey draft

Set destination URL

Set keyword

Set public comment replies

Set contact capture

Followers only on Instagram

Check and publish

Check destination link

Validate publish checklist

Publish journey

Read journeys

List journeys

Get journey

​Create and publish in one call

​Create journey

​Blocker codes

​Build step by step

​Start journey draft

​Set destination URL

​Set keyword

​Set public comment replies

​Set contact capture

​Followers only on Instagram

​Check and publish

​Check destination link

​Validate publish checklist

​Publish journey

​Read journeys

​List journeys

​Get journey

Create and publish in one call

Create journey

Blocker codes

Build step by step

Start journey draft

Set destination URL

Set keyword

Set public comment replies

Set contact capture

Followers only on Instagram

Check and publish

Check destination link

Validate publish checklist

Publish journey

Read journeys

List journeys

Get journey