> ## 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 Follower

Triggers when a user follows another user on Farcaster. Optionally filter by target FID to watch follows of specific users. Powered by Neynar webhooks.

Trigger Social

Triggers when a user follows another user on Farcaster. Optionally filter by target FID to watch follows of specific users. Powered by Neynar webhooks.

## At a Glance

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

## Trigger Configuration

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `targetFids` | `array` | No | Filter by target Farcaster IDs \(FIDs\). Only follows TO these users will trigger the workflow. |

## Trigger Result

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `triggeredAt` | `string` | Yes | Timestamp when the follow was detected \(UTC, RFC3339 format\) |
| `eventType` | `string` | Yes | Neynar event type |
| `body` | `object` | Yes | Full Neynar follow event data including user \(fid, username, display_name, pfp_url\) who followed and the target user |

## Workflow Root Example

```json
{
  "nodes": {
    "root": {
      "type": "farcaster-new-follower",
      "payload": {
        "targetFids": [
          1
        ]
      },
      "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`.