Skip to main content
POST
/
v1
/
loyalty
/
programs
Create a loyalty program
curl --request POST \
  --url https://api.yorlet.com/v1/loyalty/programs \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "<string>",
  "name": "<string>",
  "reward": {
    "type": "points",
    "points": 2
  },
  "statement_descriptor": "<string>",
  "budget": {
    "maximum_points": 2
  },
  "discoverable": true,
  "expires_at": 123,
  "max_redemptions": 2,
  "metadata": {},
  "priority": 50,
  "tier": "<string>"
}
'
{
  "id": "<string>",
  "created": 123,
  "object": "loyalty.program",
  "archived": true,
  "budget": {
    "maximum_points": 2
  },
  "description": "<string>",
  "discoverable": true,
  "expires_at": 123,
  "in_person": {
    "url": "<string>"
  },
  "name": "<string>",
  "reward": {
    "type": "points",
    "points": 2
  },
  "statement_descriptor": "<string>",
  "tier": "<string>",
  "account": "<string>",
  "deleted": false,
  "priority": 50
}

Authorizations

​
Authorization
string
header
required

API Key authentication. Use "Bearer YOUR_API_KEY".

Body

application/json
​
description
string
required

The description of the loyalty program. This will be displayed to customers.

​
name
string
required

The name of the loyalty program. Useful for organising your programmes. Not shown to customers.

​
reward
Fixed points · object
required

The reward configuration for the loyalty program.

​
statement_descriptor
string
required

The statement descriptor that will appear on the customer's statement.

​
type
enum<string>
required

The type of the loyalty program.

Available options:
rent_on_time,
tenure_milestone,
new_lease,
renewal,
move_in,
referral,
in_person,
one_time,
birthday,
custom
​
budget
Budget · object

The points budget for the loyalty program.

​
discoverable
boolean

Whether the program is discoverable by residents in the app.

​
expires_at
integer | null

The date and time the program expires.

​
max_redemptions
number

The maximum number of times the program can be redeemed.

Required range: x >= 1
​
metadata
object

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

​
priority
number

The priority of for sorting loyalty programs. If not specified, it will be set to the default value of 50. The highest priority is 0 and the lowest is 100.

Required range: 0 <= x <= 100
​
recipient_restriction
enum<string>

Restrictions on who can receive points. Set to "none" for no restrictions (any user in the OneMove network can receive points). Set to "residents" to only allow residents in your account to receive points.

Available options:
none,
residents
​
tier
string

The ID of the loyalty tier the program is associated with.

Pattern: ^[a-zA-Z0-9_]+$

Response

200 - application/json

Create a loyalty program

​
id
string
required

Unique identifier for the object.

​
created
number
required

Time at which the object was created. Measured in seconds since the Unix epoch.

​
object
enum<string>
required
Available options:
loyalty.program
​
archived
boolean
required

Whether the program is archived. Archived programs are not visible to customers.

​
budget
Budget · object
required

The points budget for the loyalty program.

​
description
string | null
required

The description of the loyalty program. This will be displayed to customers.

​
discoverable
boolean
required

Whether the program is discoverable by residents in the app.

​
expires_at
integer | null
required

The date and time the program expires.

​
in_person
object
required

The in_person object for the loyalty program.

​
name
string
required

The name of the loyalty program. Useful for organising your programmes. Not shown to customers.

​
recipient_restriction
enum<string>
required

Restrictions on who can receive points. Set to "none" for no restrictions (any user in the OneMove network can receive points). Set to "residents" to only allow residents in your account to receive points.

Available options:
none,
residents
​
reward
Fixed points · object
required

The reward configuration for the loyalty program.

​
statement_descriptor
string | null
required

The statement descriptor that will appear on the customer's statement.

​
status
enum<string>
required

The status of the loyalty program.

Available options:
active,
expired,
consumed
​
tier
required

The tier object for the loyalty program.

​
type
enum<string>
required

The type of the loyalty program.

Available options:
rent_on_time,
tenure_milestone,
new_lease,
renewal,
move_in,
referral,
in_person,
one_time,
birthday,
custom
​
account
string

The account that the object belongs to. Only returned if the request is made with a valid Yorlet-Context header.

​
deleted
boolean
default:false

Only returned if the object has been deleted.

​
priority
number

The priority of for sorting loyalty programs. If not specified, it will be set to the default value of 50. The highest priority is 0 and the lowest is 100.

Required range: 0 <= x <= 100