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 Bio. It contains

  • Default fields: Name, profile picture, address, date of birth

  • Unlimited custom fields, e.g. Marital status etc.

• The purple section is her Timeline. It contains stories that she is tagged in.

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

Documentation

• Beneficiaries are called Contacts in the front-end