Contact with Soft Credit
contact_with_cause_team (example on postman)
Use this format to add a contact and transaction to a cause team in Kindful.
Body Params
The id field is an (API) application-specific field and is used to prevent duplicates when multiple applications are connected to the same Organization account.
For more information about creating and updating records, please see Intro to Record Matching
If id is not provided then: To remove duplicates, we match based upon an exact match of firstname + lastname + email or company_name + email. This is not ideal, so specify an identifier if at all possible.
If a transaction_id isn't provided then we will generate a guid for it, to be used internally.
id
No
Contact ID
123ABC
String
first_name
Yes unless company_name is populated
last_name
Yes unless company_name is populated
String
company_name
Yes unless first and last name are populated
Use company_name if the contact is not an individual but a company. First and last name can be blank in this case, if you specify First and Last Name, this will be the Primary Contact Name on the Organization Record.
String
employer
No
Company that individual works for
No
valid email address
String
alt_email
No
valid email address
String
addr1
No
String
addr2
No
String
city
No
String
state
No
state abbreviation TN,NY
String
postal
No
valid country postal code. 5 digits if United States
String
country
No
United States
http://www.worldatlas.com/aatlas/ctycodes.htm the full name from the list above. the A2 (ISO) code also can be used.
title
No
Mr, Ms, Dr
String
birthday
No
yyyy/mm/dd
yyyy-mm-dd
String
primary_phone
No
digits or with () - -
String
alt_phone
No
String
fax_phone
No
String
spouse_first
No
String
spouse_last
No
String
gender
No
Male = M, Female=F, Unknown=U. if blank the gender will be guessed based on name
M
M/F/U
created_at
No
integer for unix timestamp (jan 1 1970) or string in UTC of ISO8601 or RFC3339 format
updated_at
No
Yes if action = update and your updating contact
integer for unix timestamp (jan 1 1970) or string in UTC of ISO8601 or RFC3339 format
campaign
No
event or category of transaction. Defaults to Partner Name
Gala, General, Mail Appeal
String
campaign_id
No
campaign identifier to minimize duplicates
String
parent_campaign
No
parent_campaign is only needed if you organize your campaigns in a hierarchy (for example, you organize your campaigns into categories). If parent_campaign is provided, it will be the parent of the provided campaign.
Events, Galas
String
parent_campaign_id
No
String
fund
No
larger group or fund of where the money ends up
https://support.kindful.com/hc/en-us/articles/217204108
General, Restricted, Africa
String
fund_id
No
fund identifier to minimize duplicates
String
cause
No
General
String
cause_id
No
12345
String
team
No
General
String
team_id
No
12345
String
team_member_first_name
No
John
String
team_member_last_name
No
Smith
String
team_member_id
No
12345
String
occupation
No
Denist
String
retired_or_not_employed
No
True/False or Yes/No
False