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

# Types of webhooks available with Affinity's API

> Help center reference

<Note>**Reference** — lookup information.</Note>

Get notified of events in your Affinity account by setting up webhooks with [Affinity's API V1](https://api-docs.affinity.co/#webhooks) (not available for API V2 at this time).

**Note**: If you're currently trialing Affinity, you will **not** be able to access the Affinity API (and therefore set up webhooks) until you purchase one of the following tiers: **Scale**, **Advanced**, or **Enterprise**. Please see [Getting started with the Affinity API + FAQs](/s/article/Getting-started-with-the-Affinity-API-faqs).

## Important Callouts

* Payload responses are formatted the same for each webhook event (created, updated, deleted), except for the ones with a "**Note:**" mentioned.
* Setting up webhooks for Affinity is only available using Affinity's API V1 at this time, not API V2. Please see the section titled "Differences between API V1 and API V2" in the article [Getting started with the Affinity API + FAQs](/s/article/Getting-started-with-the-Affinity-API-faqs).

## Frequently Asked Questions

### Do webhooks count toward my API credits?

* Creating, updating, and deleting the webhook URL or making any changes to the subscription will count towards your API credits.
* API events sent to your URL do **not** count towards your API credits.

### What events do not trigger webhooks?

* [Importing data into Affinity](/s/article/How-to-import-your-data-into-Affinity) will not trigger webhooks.
* Auto-enriched field values will not trigger webhooks (this includes [Affinity Data](/s/article/Affinity-Data), [PitchBook](/s/article/How-to-integrate-Affinity-with-Pitchbook), [Dealroom.co](/s/article/Dealroom-co-data-in-Affinity) fields, and the [enriched fields](/s/article/Enriched-Global-and-List-specific-Fields) provided by Affinity).
  * Webhooks will only get triggered within auto-enriched fields if a user decides to manually add values to these fields or delete these manually-added values in the future.

## Types of Webhooks

### Organization

Please note that the "Organization merged" webhook will provide a different response.

```json theme={null}
{
  "type": "organization.created",
  "body": {
    "id": 64779194,
    "name": "Affinity",
    "domain": "affinity.co",
    "domains": ["affinity.co"],
    "crunchbase_uuid": null,
    "global": true
  },
  "sent_at": 1636645351
}
```

### Organization Merged

```json theme={null}
{
  "type": "organization.merged",
  "body": {
    "changer": {
      "id": 38706,
      "type": 1,
      "first_name": "John",
      "last_name": "Doe",
      "primary_email": "john@affinity.co",
      "emails": []
    },
    "removed_company": {
      "id": 64779194,
      "name": "Affinity",
      "domain": "affinity.co",
      "domains": ["affinity.co"],
      "crunchbase_uuid": null,
      "global": true
    },
    "company": {
      "id": 64779195,
      "name": "Affinity 2",
      "domain": "affinity.co",
      "domains": ["affinity.co"],
      "crunchbase_uuid": null,
      "global": false
    },
    "merged_at": "2021-11-15 13:45:16 -0800"
  },
  "sent_at": 1637012717
}
```

### Person

Please note that `organization_ids` is not returned when a `Person` is deleted.

```json theme={null}
{
  "type": "person.created",
  "body": {
    "id": 38706,
    "type": 0,
    "first_name": "John",
    "last_name": "Doe",
    "primary_email": "john@affinity.co",
    "emails": [],
    "organization_ids": []
  },
  "sent_at": 1636645209
}
```

### Opportunity

Please note that `organization_ids` and `person_ids` are not returned when an `Opportunity` is deleted.

```json theme={null}
{
  "type": "opportunity.created",
  "body": {
    "id": 7460748,
    "name": "Amazon - Project A",
    "person_ids": [],
    "organization_ids": []
  },
  "sent_at": 1636645558
}
```

### List

```json theme={null}
{
  "type": "list.created",
  "body": {
    "id": 450,
    "ip_address": "208.253.143.17"
  },
  "sent_at": 1636642627
}
```

### List Entry

```json theme={null}
{
  "type": "list_entry.created",
  "body": {
    "id": 16367,
    "list_id": 450,
    "creator_id": 38706,
    "entity_id": 287125,
    "entity_type": 1,
    "created_at": "2021-11-11 06:58:31 -0800",
    "entity": {
      "id": 84547971,
      "type": 1,
      "first_name": "John",
      "last_name": "Doe",
      "primary_email": "jdoe@jdoe.com",
      "emails": ["jdoe@jdoe.com", "jdoe2@jdoe2.com"]
    }
  },
  "sent_at": 1636642712
}
```

### Field

```json theme={null}
{
  "type": "field.created",
  "body": {
    "id": 59,
    "name": "Deals Amount",
    "list_id": 11,
    "value_type": 3,
    "allows_multiple": false,
    "track_changes": false,
    "dropdown_options": [],
    "ip_address": "206.253.143.17"
  },
  "sent_at": 1636644238
}
```

### Field Value

```json theme={null}
{
  "type": "field_value.created",
  "body": {
    "id": 250616,
    "field_id": 337,
    "list_entry_id": null,
    "entity_type": 38706,
    "value_type": 0,
    "entity_id": 91407761,
    "value": {
      "city": "San Francisco",
      "state": "California",
      "country": "United States",
      "continent": null,
      "street_address": null
    },
    "field": {
      "id": 318500,
      "name": "Location",
      "list_id": null,
      "value_type": 5,
      "allows_multiple": false,
      "track_changes": false,
      "dropdown_options": []
    }
  },
  "sent_at": 1636635565
}
```

### Notes

```json theme={null}
{
  "type": "note.created",
  "body": {
    "id": 22984,
    "creator_id": 860197,
    "person_ids": [38706, 89734],
    "is_meeting": false,
    "organization_ids": [],
    "opportunity_ids": [],
    "parent_id": null,
    "content": "Had a lunch meeting with Jane and John today.",
    "created_at": "2021-11-11 07:21:10 -0800",
    "ip_address": "206.253.143.17"
  },
  "sent_at": 1636644072
}
```

### File

```json theme={null}
{
  "type": "file.created",
  "body": {
    "id": 43212,
    "name": "JohnDoeFriends.csv",
    "size": 993,
    "person_id": 10,
    "organization_id": null,
    "opportunity_id": null,
    "created_at": "2021-11-11 07:54:36 -0800",
    "uploader_id": 64056952
  },
  "sent_at": 1636646078
}
```


## Related topics

- [Crunchbase data in Affinity](/s/article/Crunchbase-data-in-Affinity.md)
- [Affinity Data](/s/article/Affinity-Data.md)
- [What Are The Different Seat Types Available In Affinity](/s/article/What-are-the-different-seat-types-available-in-Affinity.md)
- [Getting Started With The Affinity API + FAQs](/s/article/Getting-started-with-the-Affinity-API-faqs.md)
- [What Data Is Accessible Via The Affinity API](/s/article/What-data-is-accessible-via-the-Affinity-API.md)
