B1G1 APIs
Welcome to the B1G1 API documentation!
You can use our APIs to add your Giving Stories to the Giving Cart. In future, we will be expanding our public APIs to allow you to add Favourite Projects to the Giving Cart, as well as access and update all your Giving Stories and Favourite Projects.
All responses from the APIs are in JSON. You can view code examples in cURL or your preferred language using the dropdown on the right.
At the moment, all our APIs are available and accessible to B1G1 members for free, and we are actively seeking feedback and suggestions to inform development efforts.
We hope that what we build helps you embed giving into the heart of your business more effectively. And we can't wait to see how you’ll use these APIs to create more impact in the world than anyone has ever imagined.
If you have any feedback or suggestions about our APIs, please reach out to us at team@b1g1.com.
POSTAdd Giving Story to Cart
This endpoint adds a specific Giving Story to your company's Giving Cart using the POST
method.
Here's how to retrieve the URL of the endpoint from your B1G1 account:

Once you have successfully added your Giving Story to the Cart, the API will also send back a payload of the details of the Story you have just added.
Errors
Errors could occur if:
- Your B1G1 account is no longer active (blocked, suspended, or deactivated) -> please reach out to the B1G1 team at team@b1g1.com.
- The Giving Story is deleted or otherwise no longer available -> please verify that the Giving Story is still in your B1G1 account and that you used the correct endpoint URL.
- The Project in the Giving Story is delisted or otherwise no longer available -> please change the project within your Giving Story or use another Giving Story instead.