API reference · Campaign Templates
List campaign templates
GET/v1/campaign-templates
List all campaign templates.
Requires a Bearer access token.
Parameters
limit#numberin queryintegerminimum 1maximum 100The max number of items to return.
cursor#stringin queryUUIDThe id of the last item from the previous page. Used to fetch the next page.
language#stringin queryGet templates in a specific language.
frentype#stringin queryFilter by type.
GENERICINDUSTRY_SPECIFICsegment#stringin queryFilter by segment.
CSRMARKETINGHRSALESCOMMUNICATIONGLOBALSMBcampaignTemplateGoalId#stringin queryUUIDFilter by goal.
slug#stringin queryFind a campaign template by its slug.
includeCampaigns#booleanin queryInclude campaigns
Required in the spec, optional for the API.
Response
200 · LocalizedCampaignTemplate[]No field is described in the spec.
campaignTemplateId#stringalways returnedname#stringalways returneddescription#stringalways returnedwhy#stringalways returneddonationMethod#stringalways returnedslug#stringalways returnedtype#CampaignTemplateTypealways returnedGENERICINDUSTRY_SPECIFICsegment#CampaignTemplateSegmentalways returnedCSRMARKETINGHRSALESCOMMUNICATIONGLOBALSMBindustry#CampaignTemplateIndustryalways returnedALLRETAILITFINANCETRANSPORTENERGYHOSPITALITYEDUCATIONSERVICESWELLNESSENTERTAINMENTisFeatured#booleanalways returnedisSelfServe#booleanalways returnedisInternal#booleanalways returnedcauses#Cause[]always returnedcreatedAt#string (date-time)always returnedupdatedAt#string (date-time)always returnedgoals#CampaignTemplateGoal[]always returned5 child fields
campaignTemplateGoalIdstringalways returnedlabelstringalways returnedslugstringalways returnedcreatedAtstring (date-time)always returnedupdatedAtstring (date-time)always returned
Errors
400accountId is required when includeCampaigns is true
{ "statusCode": 400, "message": "accountId is required when includeCampaigns is true", "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 GET https://api.sandbox.charitips.com/v1/campaign-templates \ -H "Authorization: Bearer $CHARITIPS_TOKEN"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.