Introduction

• Beneficiary is the back-end term for what in the front-end is called a Contact

• This 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 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

required: owner_id, name

body:{ "beneficiary": { "name": "Jack", "date_of_birth": "13-05-1899", "address": "Paris", "latitude": "48.856613", "longitude": "2.352222", "beneficiary_type_id": 1, "owner_id": 237 }, "project_ids": [572], "custom_fields": {"173": "3256895684"}, "beneficiary_category_ids": [294] }

header: {'X-User-Token': 'Ppteex1dWbEcnNC311NFOrJqNHP98zN2ccMpWEei--ixL50J7uZsnprbOu--WbOcz50zaS48JzyXXZHS9A==',
'X-User-Email': ‘soft.dave99@gmail.com’}

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