> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Farcaster: New Cast

Triggers when a new cast (post) is published on Farcaster. Optionally filter by author FID, mentioned users, text pattern, or channel URL. Powered by Neynar webhooks.

Trigger Social

Triggers when a new cast (post) is published on Farcaster. Optionally filter by author FID, mentioned users, text pattern, or channel URL. Powered by Neynar webhooks.

## At a Glance

| Field | Value |
| --- | --- |
| Trigger ID | `farcaster-new-cast` |
| Category | Social |
| Tags | `farcaster`, `social`, `cast`, `post`, `neynar`, `webhook` |

## Trigger Configuration

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `authorFids` | `array` | No | Filter by author Farcaster IDs \(FIDs\). Only casts from these users will trigger the workflow. |
| `mentionedFids` | `array` | No | Filter by mentioned Farcaster IDs. Only casts mentioning these users will trigger. |
| `textPattern` | `string` | No | Regex pattern to match against cast text \(e.g., '\bbase\b' for word 'base'\). |
| `channelUrl` | `string` | No | Filter by Farcaster channel URL \(e.g., 'https://warpcast.com/~/channel/base'\). |

## Trigger Result

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `triggeredAt` | `string` | Yes | Timestamp when the cast was detected \(UTC, RFC3339 format\) |
| `eventType` | `string` | Yes | Neynar event type |
| `body` | `object` | Yes | Full Neynar cast event data including hash, author \(fid, username, display_name, pfp_url\), text, timestamp, embeds, channel, reactions, replies, mentioned_profiles |

## Workflow Root Example

```json
{
  "nodes": {
    "root": {
      "type": "farcaster-new-cast",
      "payload": {
        "authorFids": [
          1
        ],
        "mentionedFids": [
          1
        ],
        "textPattern": "Workflow completed",
        "channelUrl": "https://example.com/webhook"
      },
      "children": [
        "log_event"
      ]
    },
    "log_event": {
      "type": "log",
      "payload": {
        "message": "Triggered at {{$trigger.triggeredAt}}"
      },
      "children": []
    }
  }
}
```

**Reference trigger output**

Downstream nodes can use `{{$trigger.triggeredAt}}` and any result fields listed above. Event triggers usually expose the raw source payload under a field such as `event`, `body`, `trade`, or `raw`.