Event Record Matching

Event Matching Behavior

Events can be appended to by the following methods. This allows you to import contacts and transactions with event(s) without creating duplicates.

Import Types

Event matching can take place on contact_with_transaction import API.

Parameter
Notes
Type

id

Will match the records id field to Kindful's event id.

String

name

Will match the record's name field by Kindful's event name.

String

Example 1 - Match by Event Name or Create Event by Name

In the first example below, we are appending to event, " 2016 Stache Bash".

Because match_by is set to match on event's name field, if "2016 Stache Bash" exists then the contact and transaction will be assigned to the associated event. If the event does not exist, then a new event will be created and the contact and transaction assigned to the new event.

{
  "data_format": "contact_with_transaction",
  "data_type": "json",
  "match_by": {
    "event": "name"
  },
  "action_type": "create",
  "data": [
    {
      "id": "2468", 
      "first_name": "Ron", 
      "last_name": "Swanson", 
      "email": "dontemailme@email.com", 
      "amount_in_cents": "5000",
      "transaction_time": "2016-10-13 18:56:12 UTC",
      "fund": "Fundraising Events",
      "fund_id": "e2016",
      "event_id": "9",
      "event": "2016 Stache Bash"
    }
  ] 
}

Example 2 - Match by Event ID

In the example below, we are appending to the Event by id "10".

Because match_by is set to match on event's id field, and id 10 is the 2016 Ramsett Park Shindig event the contacts will be assigned to the associated groups.

If you set match_by id and passed in a event ID that does not yet exist in Kindful, Kindful will create a event that is named as the event ID. We DO NOT recommend this and instead recommend that if you are creating new events, that you create by event name (example #1).

{
  "data_format": "contact_with_transaction",
  "data_type": "json",
  "match_by": {
    "event": "id"
  },
  "action_type": "create",
  "data": [
    {
      "id": "2468", 
      "first_name": "Leslie", 
      "last_name": "Knope", 
      "email": "mrspresident@email.com", 
      "amount_in_cents": "5001",
      "transaction_time": "2016-10-13 18:56:15 UTC",
      "fund": "Fundraising Events",
      "fund_id": "e2016",
      "event_id": "10",
      "event": "2016 Ramsett Park Shindig"
    }
  ] 
}