API reference · Charities Selections
Create a charities selection
POST/v1/charities-selections
No description in the spec yet.
Requires a Bearer access token.
Body
CreateCharitiesSelectionDtoname#stringrequired2 to 100 charactersName of the selection.
charityIds#string[]UUIDIds of the selected charities.
campaignId#stringUUIDOptionally link it directly to an existing campaign.
accountId#stringUUIDOnly required to link the created entity to a child account instead of the current one.
featuredCharitiesIds#string[]UUIDIds of the featured charities. These charities will be displayed first in the list of charities. Warning: The featured charities must be part of the selected charities.
Response
201 · CharitiesSelectionNo field is described in the spec.
charitiesSelectionId#stringalways returnedname#stringalways returnedtype#CharitiesSelectionTypealways returnedGENERICCUSTOMfeaturedCharitiesIds#string[]always returnedisFeatured#booleanalways returnedaccountId#stringcreatedAt#string (date-time)always returnedupdatedAt#string (date-time)always returnedcharities#OnlyCharityId[]always returned1 child field
charityIdstringalways returned
Errors
400A selection must have at least one charity to be linked to a campaign
{ "statusCode": 400, "message": "A selection must have at least one charity to be linked to a campaign", "error": "Bad Request" }400Featured charities must be part of the selected charities: <join(', ')>
{ "statusCode": 400, "message": "Featured charities must be part of the selected charities: <join(', ')>", "error": "Bad Request" }400A field is missing, has the wrong type, or is not part of the request schema.
Every request with a body or query is validated.
{ "statusCode": 400, "message": [ "amount must not be less than 1", "property foo should not exist" ], "error": "Bad Request" }401Unauthorized
Missing, expired or invalid access token.
{ "statusCode": 401, "message": "Unauthorized" }403Account closed
{ "message": "Account closed", "code": "ACCOUNT_CLOSED" }
curl -X POST https://api.sandbox.charitips.com/v1/charities-selections \ -H "Authorization: Bearer $CHARITIPS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "Checkout charities", "charityIds": [ "<charityId>" ] }'Request bodies are written for this docs and checked against the API's validation; ids in angle brackets are placeholders. Response values are placeholders built from the schema.