---
title: "Adds or updates a member"
method: POST
path: "/endpoints/members"
tags: ["Members"]
---

# Adds or updates a member

`POST /endpoints/members`

## Request

- Base URL: `https://app.hullo.me/api`
- URL: `https://app.hullo.me/api/endpoints/members`
- Auth: API key in header `X-API-KEY`

Add or update the information hullo stores for a specific member. If the member doesn't already exist then   
they will be added to the members store and an opt-in message will be sent to the number specified in order  
to get confirmation that the number exists and wishes to receive messages. If the member responds with a  
confirmation message ("yes") then their member record will be updated to opted-in and they will then be able  
to receive messages sent to them from any hullo campaign. If the member already exists then their record will 
be updated to reflect any new / updated attribute data included in the call. If an attribute is specified but  
no value is given or the value is null then that attribute will be deleted from the members record.

## Request body

- Member: A record containing information about a member
  - `registrationDate` string, date-time: The date the member was registered
  - `phoneNumber` string, phone-number, required: The phone number of the member
  - `fullName` string: The full name of the member as "<forename> <surname>"
  - `attributes` object, required: The attributes that describe the member
  - `groups` string[]: The list of groups this member belongs to

## Response `200`

OK

- Member: A record containing information about a member
  - `registrationDate` string, date-time: The date the member was registered
  - `phoneNumber` string, phone-number, required: The phone number of the member
  - `fullName` string: The full name of the member as "<forename> <surname>"
  - `attributes` object, required: The attributes that describe the member
  - `groups` string[]: The list of groups this member belongs to

## Other responses

- `400`: BAD_REQUEST
- `401`: UNAUTHORIZED
- `404`: NOT_FOUND

---

[API](https://skmtc.dev/hullo/apis/always-on-mobile-hullo-api.md) · [All operations](https://skmtc.dev/hullo/apis/always-on-mobile-hullo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hullo/apis/always-on-mobile-hullo-api/revisions/62982404791d?raw)