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

data_format
string
action_type
string
data_type
string

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.

columns
required
notes
example
type

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

email

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

https://support.kindful.com/hc/en-us/articles/217204108

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