Donations are fundraising campaigns: a story, an optional target amount, predefined amounts to give and add-on options such as a gift.
Endpoints that need a token: the site owner creates it in their admin (Developers > API reference). AI assistants: how to ask the user for one.
5 endpoints.
The donations page, or the campaigns as JSON with ?ionic. Paged with ?skip. Cached for an hour.
Needs a signed-in user whose plan grants access.
Only donations with this published.
Only donations with this completed.
The order of the results.
Only results in this collection.
How many results to skip - for paging.
Only donations with this where.
Returns a list of Donation objects.
curl -X GET 'http://smartman.max-media.io/donations?ionic=true&published=...&completed=...&sortBy=...' \ -H 'Authorization: Bearer <TOKEN>'
[
{
"enabled": false,
"has_shippable_items": false,
"medias": [
{
"media": "6543210fedcba98765432100",
"gcs_url": "example-item",
"gcs_480_30_url": "example-item",
"gcs_720_30_url": "example-item",
"gcs_1080_30_url": "example-item",
"duration": 1,
"vimeo_uri": "example",
"vimeo_picture": "example",
"vimeo_url": "example-item",
"youtube_url": "example-item",
"youtube_picture": "example",
"thumbnail": "example",
"_id": "6543210fedcba98765432100"
}
],
"url": "example-item",
"static_url": "example-item",
"title": "Example",
"description": "Text shown on the site.",
"about_page": "6543210fedcba98765432100",
"collection_id": "6543210fedcba98765432100",
"topics": [
{
"collection_id": "6543210fedcba98765432100",
"_id": "6543210fedcba98765432100"
}
],
"owner_id": "6543210fedcba98765432100",
"options": [
{
"name": "Example",
"options": [],
"_id": "6543210fedcba98765432100"
}
],
"_id": "6543210fedcba98765432100",
"updatedAt": "2026-11-04T12:00:00.000Z",
"createdAt": "2026-11-04T12:00:00.000Z",
"target_amount": {
"enabled": false,
"amount": 0
},
"predefined_amounts": {
"enabled": false,
"amounts": "example"
}
}
]Creates a donation campaign. Answers 201 with the campaign.
Needs a site admin token.
Name of the campaign, required.
Returns the Donation object.
curl -X POST 'http://smartman.max-media.io/donations?ionic=true' \
-H 'Authorization: Bearer <TOKEN>' \
-H 'Content-Type: application/json' \
-d '{ "title": "..." }'{
"enabled": false,
"has_shippable_items": false,
"medias": [
{
"media": "6543210fedcba98765432100",
"gcs_url": "example-item",
"gcs_480_30_url": "example-item",
"gcs_720_30_url": "example-item",
"gcs_1080_30_url": "example-item",
"duration": 1,
"vimeo_uri": "example",
"vimeo_picture": "example",
"vimeo_url": "example-item",
"youtube_url": "example-item",
"youtube_picture": "example",
"thumbnail": "example",
"_id": "6543210fedcba98765432100"
}
],
"url": "example-item",
"static_url": "example-item",
"title": "Example",
"description": "Text shown on the site.",
"about_page": "6543210fedcba98765432100",
"collection_id": "6543210fedcba98765432100",
"topics": [
{
"collection_id": "6543210fedcba98765432100",
"_id": "6543210fedcba98765432100"
}
],
"owner_id": "6543210fedcba98765432100",
"options": [
{
"name": "Example",
"options": [],
"_id": "6543210fedcba98765432100"
}
],
"_id": "6543210fedcba98765432100",
"updatedAt": "2026-11-04T12:00:00.000Z",
"createdAt": "2026-11-04T12:00:00.000Z",
"target_amount": {
"enabled": false,
"amount": 0
},
"predefined_amounts": {
"enabled": false,
"amounts": "example"
}
}Updates a donation campaign. Answers the campaign, or 404.
Needs a site admin token.
The ID of the donation.
Returns the Donation object.
curl -X PATCH 'http://smartman.max-media.io/donations/{id}?ionic=true' \
-H 'Authorization: Bearer <TOKEN>'{
"enabled": false,
"has_shippable_items": false,
"medias": [
{
"media": "6543210fedcba98765432100",
"gcs_url": "example-item",
"gcs_480_30_url": "example-item",
"gcs_720_30_url": "example-item",
"gcs_1080_30_url": "example-item",
"duration": 1,
"vimeo_uri": "example",
"vimeo_picture": "example",
"vimeo_url": "example-item",
"youtube_url": "example-item",
"youtube_picture": "example",
"thumbnail": "example",
"_id": "6543210fedcba98765432100"
}
],
"url": "example-item",
"static_url": "example-item",
"title": "Example",
"description": "Text shown on the site.",
"about_page": "6543210fedcba98765432100",
"collection_id": "6543210fedcba98765432100",
"topics": [
{
"collection_id": "6543210fedcba98765432100",
"_id": "6543210fedcba98765432100"
}
],
"owner_id": "6543210fedcba98765432100",
"options": [
{
"name": "Example",
"options": [],
"_id": "6543210fedcba98765432100"
}
],
"_id": "6543210fedcba98765432100",
"updatedAt": "2026-11-04T12:00:00.000Z",
"createdAt": "2026-11-04T12:00:00.000Z",
"target_amount": {
"enabled": false,
"amount": 0
},
"predefined_amounts": {
"enabled": false,
"amounts": "example"
}
}Deletes a donation campaign. Answers the deleted campaign, or 404.
Needs a site admin token.
The ID of the donation.
Returns an empty answer on success.
curl -X DELETE 'http://smartman.max-media.io/donations/{id}?ionic=true' \
-H 'Authorization: Bearer <TOKEN>'A campaign's page, or JSON with ?ionic. By url, not id. 404 when there is no such campaign.
Pages limited to some users check the token when one is sent.
The donation's URL slug, as in its address on the site.
Only donations with this session id.
Returns the Donation object.
curl -X GET 'http://smartman.max-media.io/donations/{url}?ionic=true&sessionId=...'{
"enabled": false,
"has_shippable_items": false,
"medias": [
{
"media": "6543210fedcba98765432100",
"gcs_url": "example-item",
"gcs_480_30_url": "example-item",
"gcs_720_30_url": "example-item",
"gcs_1080_30_url": "example-item",
"duration": 1,
"vimeo_uri": "example",
"vimeo_picture": "example",
"vimeo_url": "example-item",
"youtube_url": "example-item",
"youtube_picture": "example",
"thumbnail": "example",
"_id": "6543210fedcba98765432100"
}
],
"url": "example-item",
"static_url": "example-item",
"title": "Example",
"description": "Text shown on the site.",
"about_page": "6543210fedcba98765432100",
"collection_id": "6543210fedcba98765432100",
"topics": [
{
"collection_id": "6543210fedcba98765432100",
"_id": "6543210fedcba98765432100"
}
],
"owner_id": "6543210fedcba98765432100",
"options": [
{
"name": "Example",
"options": [],
"_id": "6543210fedcba98765432100"
}
],
"_id": "6543210fedcba98765432100",
"updatedAt": "2026-11-04T12:00:00.000Z",
"createdAt": "2026-11-04T12:00:00.000Z",
"target_amount": {
"enabled": false,
"amount": 0
},
"predefined_amounts": {
"enabled": false,
"amounts": "example"
}
}