• Register



This service enables users to enroll in a Loyalty account

 back to top

HTTP Method and Request URL



back to top

HTTP, Path and Query Parameters

HTTP Header Parameters

Parameter Description Mandatory Sample Value
x-macys-webservice-client-id Pass the apikey as a header value which is called x-macys-webservice-client-id. The api key is the 24 character alphanumeric string assigned to your application when you registered it. 
Click here for a list of your API keys.
Yes xmj9js4jkdpe1983fmwu98gh
x-macys-clientId: The Client_ID you were assigned, if this applies.  No client_id
Accept Specifies the output format. Can be application/json or application/xml. Yes application/json

Request Body Parameters
Parameter Description Mandatory Sample Value
firstName This is the users first name. Yes Jeff
lastName This is the users last name.
 Yes,  Bennett
addressLine1 line 1 of of user's address Yes 150 Post St
addressLine2 line 2 of user's address Yes Apt. C
postalCd This users zipcode.  Yes,  94107
phone This is the users phone number. Yes 8002896229
StateCd State the User Lives In Yes CA
city City the user lives in Yes Fremont
email This is the users email address Yes, johnmiller@gmail.com
dayOf Birth Numerical Value of the day of birth Yes 14
MonthofBirth   Numerical Value of Birth Month Yes 7

back to top

Sample Requests and Responses

Request URL:



Sample Header:

x-macys-webservice-client-id: xmj9js4jkdpe1983fmwu98gh
x-macys-clientId: client_id
Accept: application/json


Request Body(Payload)


Sample Request Body (Payload)

  "loyalty": {
    "firstName": "Jeff",
    "lastName": "Bloomie",
    "addressLine1": "4425 Bidwell Dr",
    "addressLine2": "Apt H",
    "city": "Fremont",
    "stateCd": "CA",
    "postalCd": "94538",
    "phone": "723-734-1234",
    "email": "jeff@test.com",
    "dayOfBirth": "28",
    "monthOfBirth": "07"


Sample Response Header

201 Created
Response headers 
X-Mashery-Responder: prod-j-worker-atl-01.mashery.com
X-Mashery-Message-ID: 67c04307-70dd-4ca6-9968-a259f7e255b0
Vary: Accept 
Content-Length: 0 
Content-Type: text/plain 
Server: Mashery Proxy 
Date: Mon, 02 Mar 2015 19:05:01 GMT 
Connection: keep-alive
Set-Cookie: TS019a6071=01884915da0f4859f2ee0540f6dc590ea7e046af95a502b7f3cf67a94f82a94d227a1a2e6a; Path=/ 


back to top

Error Codes

Call Specific Error Codes:


General Error Handling Documentation:

Click Here

back to top

Docs Navigation