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

# Create an Intent

> [!NOTE]
>
> **Beta.** Intent must be enabled for your team. Contact your Method CSM to request access.

Creates a new Intent for a user journey event. If Method recognizes the user, Method begins refreshing their eligible liability data in the background, so the more recent data is ready sooner when the user reaches Connect and Updates.

Operation Type: ⚡ Synchronous (Your request is processed immediately, and you'll receive a response before proceeding.)

## Body

## Returns

Returns the newly created Intent. The response does not indicate whether a match occurred.

```bash cURL theme={null}
curl https://production.methodfi.com/intents \
  -X POST \
  -H "Method-Version: 2026-03-30" \
  -H "Authorization: Bearer sk_WyZEWVfTcH7GqmPzUPk65Vjc" \
  -H "Idempotency-Key: 7bd52b4f-c5e3-4d0c-8b20-6a754781f2d9" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "lending.offer_sent",
    "identity": {
      "individual": {
        "first_name": "Kevin",
        "last_name": "Doyle",
        "phone": "+15121231111",
        "email": "kevin.doyle@gmail.com",
        "dob": "1997-03-18",
        "address": {
          "line1": "3300 N Interstate 35",
          "line2": null,
          "city": "Austin",
          "state": "TX",
          "zip": "78705"
        }
      }
    },
    "context": {
      "external_user_id": "usr_8f2d1c",
      "session_id": "sess_41b7e9",
      "source": "email"
    },
    "metadata": {
      "campaign_id": "fall_prescreen"
    }
  }'
```

```bash cURL (Entity) theme={null}
curl https://production.methodfi.com/intents \
  -X POST \
  -H "Method-Version: 2026-03-30" \
  -H "Authorization: Bearer sk_WyZEWVfTcH7GqmPzUPk65Vjc" \
  -H "Idempotency-Key: 3f1c9a2e-8d4b-4e6f-9a1d-2c5b7e8f0a13" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "user.logged_in",
    "identity": {
      "entity_id": "ent_au22b1fbFJbp8"
    },
    "context": {
      "external_user_id": "usr_8f2d1c",
      "source": "app"
    }
  }'
```

```json theme={null}
{
  "id": "int_evt_aMm7rbqXxkqHR",
  "event": "lending.offer_sent",
  "context": {
    "external_user_id": "usr_8f2d1c",
    "session_id": "sess_41b7e9",
    "source": "email",
    "client_ip_address": null,
    "client_user_agent": null
  },
  "metadata": {
    "campaign_id": "fall_prescreen"
  },
  "created_at": "2026-11-10T18:00:00.000Z",
  "updated_at": "2026-11-10T18:00:00.000Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.