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.
Returns the site's donations, newest first unless a sort is given.
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://cloudoffice-gr.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 from the fields sent.
Needs a site admin token.
Name of the campaign, required.
Returns the Donation object.
curl -X POST 'http://cloudoffice-gr.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"
}
}Changes the fields sent; the others stay as they are.
Needs a site admin token.
The ID of the donation.
Returns the Donation object.
curl -X PATCH 'http://cloudoffice-gr.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 the donation. This cannot be undone.
Needs a site admin token.
The ID of the donation.
Returns an empty answer on success.
curl -X DELETE 'http://cloudoffice-gr.max-media.io/donations/{id}?ionic=true' \
-H 'Authorization: Bearer <TOKEN>'Returns one donation, found by its URL slug.
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://cloudoffice-gr.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"
}
}