# Push a lead (/api-reference/lead-intake-webhook/pushLead)

## POST /api/v1/webhooks/leads/{webhook_token}

Operation ID: `pushLead`
Push a lead
Send the integration key in `X-Lead-Webhook-Key` (or as `?key=`). Limited to 300 requests per minute per IP. Errors return `{"success": false, "error": "..."}`.

### Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `webhook_token` | path | yes | The token in your integration's URL. |

### Request body

`application/json` (required)

```json
{
  "additionalProperties": true,
  "description": "Any other top-level fields are kept on the lead as additional data. Phone or email is required.",
  "properties": {
    "company": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "is_test": {
      "description": "Check the connection without creating a lead.",
      "type": "boolean"
    },
    "lead_id": {
      "description": "Your ID for this lead. A repeat with the same ID is ignored. Without it, repeats are recognised by phone, email and name.",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "phone": {
      "description": "Phone number, for example `+919876543210`. Saved in E.164 form when it parses (no country code means India); otherwise saved as sent.",
      "type": "string"
    },
    "title": {
      "type": "string"
    }
  },
  "type": "object"
}
```

Example:

```json
{
  "city": "Pune",
  "email": "asha@example.com",
  "lead_id": "form-8812",
  "name": "Asha Rao",
  "phone": "9876543210"
}
```

### Responses

#### 200 OK

Example (example):

```json
{
  "campaignAttached": true,
  "externalLeadId": "form-8812",
  "leadId": "5a1d2c3b-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
  "success": true
}
```

#### 400 The payload was rejected, for example no phone or email.

Example (example):

```json
{
  "error": "Lead must include phone or email",
  "success": false
}
```

#### 401 The integration key is missing or wrong.

Example (example):

```json
{
  "error": "invalid webhook key",
  "success": false
}
```

#### 404 No active integration has this token.

Example (example):

```json
{
  "error": "integration not found",
  "success": false
}
```

#### 429 More than the allowed requests per minute from this IP.

Example (example):

```json
{
  "error": "rate limit",
  "success": false
}
```

#### 500 The lead could not be saved; `error` says why. Retry: repeats are dropped.

Example (example):

```json
{
  "error": "database unavailable",
  "success": false
}
```
