/associateEventContributors
Updated
by
Jon Doehling
Associate Event Contributor API Call
- The associate event contributor call is extremely useful in regards to grouping together contributors into households. Contributors who purchase multiple tickets to an event should be associated together as a best practice. This greatly improves the registration process and opens up features that stremline the process such as updating guest names, express check-in, and sharing bidder numbers for the auction.
- Contributors who are associated may share a bidder number if desired. Best practice is to assume they will be sharing a bidder number if they are part of a household (i.e. husband and wife, or same sex partners). However associated contributors can also be part of larger groups such as when a company purchases a sponsorship with 10 admissions. In this case, it shoudl be assumed that contributors in the association would each want thier own bidder number.
Production Endpoint: https://auctionconductor.com/API/associateEventContributor
Test Endpoint: https://actestserver.com/API/associateEventContributor
Accepted Data
Parameter | Req’d | Format | Default | Description |
event_id | Y | Number | (none) | Unique identifier for the event. Organization assigned to the event must match the API key. |
primary_event_contributor_id | Y | Number | (none) | Unique identifier for the primary contributor in relation to the event. The Primary Contributor will be assigned control over the group for functions like re-assiging admission tickets to other people. This should be the ticket purchaser in all cases. |
event_contributor_ids | Y | Number | (none) | Unique identifiers for the secondary contributors in relation to the event. One or more contributor id's may be accepted per call. |
share_bidder_number | N | Boolean | False | Specifies if teh secondary contributors shall share a bidder number with the primary contributor. This is highly reccommended for private households, but not for corporate groups. If true, all contributors must already have the Patron Contributor Type assigned. |
Return Values
Parameter | Value | Description |
event_contributor_id | number | Unique identifier for each of the associated contributors in relation to the event. |
bidder_number | number | Possibly shared, possibly dynamic number assigned to the event contributor. Essentially a username in number format. |
Error Codes
Code | Message | Details |
1000 | Primary Event contributor ID XXXX is not a PATRON type. Bidder number can not be assigned. | In order to share a bidder number, all associated event contributors must have the contributor type of Patron. |
Sample Call
{
event_id: "2442",
primary_event_contributor_id: "66074",
event_contributor_ids: "66075, 66076, 66077",
share_bidder_number: "true"
}Sample Response
[
{
"event_contributor_id": 66074,
"bidder_number": 115
},
{
"event_contributor_id": 66075,
"bidder_number": 115
},
{
"event_contributor_id": 66076,
"bidder_number": 115
},
{
"event_contributor_id": 66077,
"bidder_number": 115
}
],
