...
...
Introduction
Beneficiary is the back-end term for what in the front-end is called a Contact
The screenshot below is a typical Contact Profile Page on Makerble for a contact called Abigail Holmes
The red section is her BioThis is what the action of creating a beneficiary looks like in the front end. The process is
Choose which project the beneficiary will be created within (How to get the projects)
Choose which Beneficiary Category aasigned to that project will be used to create the beneficiary (How to get the Beneficiary Categories assigned to a particular project)
Choose which one of the Beneficiary Types - Person, Organisation, Animal or Object - assigned to that Beneficiary Category will be used to create the beneficiary (How to get the Beneficiary Types assigned to a particular Beneficiary Category)
Display the fields of that beneficiary category (How to get the fields of a particular Beneficiary Category)
User can complete those fields (some of which are mandatory, such as Name) to create the beneficiary
...
Once the beneficiary is created, there will be a Contact Profile Page for them in the front end
The information from the Post Beneficiary API request will go into the red section of the Contact Profile Page which is called the Bio in the front end. It contains
Default fields: Name, profile picture, address, date of birth
Unlimited custom fields, e.g. Marital status etc.
The purple section is her the Timeline. It contains stories that she is tagged in. These are created separately using the Stories API.
...
API Documentation
Desc: Post a single contact
url: /beneficiaries
method: POST
...
response example: default response example (single record)
...
...
Walkthrough an example
This article provides an example of the calls to make to the Makerble API and the responses you can expect back when going through the process of creating a beneficiary.
...
Documentation
Beneficiaries are called Contacts in the front-end