user
Description
To modify a user, you must be connected to the API using an OAuth token with user_full_access scope.
A FoxyCart User is someone who manages and configures a FoxyCart Store. It is often the owner of that store, but might also be someone paid to be responsible for aspects of the store. There can be many users per store and any user can access many stores. Before creating a user, you must create a client. When you create a user, you'll get a response back containing an OAuth token giving you access to the user.
If you create custom attributes for a user, they will automatically be included in the response as embedded resources without having to zoom in on them.
Sandbox Example
You can interact with this resource and run actions against the sandbox API via our HAL Brower.
Actions
- GET
- View a user
- PATCH
- Update a user (send only the properties you want to modify)
- PUT
- Replace a user (send the entire representation)
- DELETE
- Delete a user
- HEAD
- Get just the header response
- OPTIONS
- Get a response explaining which HTTP methods are supported
Properties
Property | Description | Type | Constraints |
---|---|---|---|
first_name | The user's given name. | String | Required. 50 characters or less. |
last_name | The user's surname. | String | Required. 50 characters or less. |
The user's email address. This is used as the login to the FoxyCart admin for this user. | Required. 100 characters or less. | ||
phone | The user's phone number. | String | 50 characters or less. |
affiliate_id | This can only be set during user creation. Contact us if you need this value changed later. | Integer | Can only be set on creation. |
is_programmer | If this user is a programmer who writes server side code in languages like PHP, .NET, Python, Java, Ruby, etc | Boolean | true or false, 1 or 0. |
is_front_end_developer | If this user is a front end developer who writes code in things like HTML, CSS, and maybe some JavaScript. | Boolean | true or false, 1 or 0. |
is_designer | If this user is a front end designer who works in wireframes, graphic designs, and user interfaces. | Boolean | true or false, 1 or 0. |
is_merchant | If this user is a a merchant or store admin involved in the item and money side of the e-commerce business. | Boolean | true or false, 1 or 0. |
date_created | The date this resource was created. | Date | Read only |
date_modified | The date this resource was last modified. | Date | Read only |
Example Representation
{ "_links": { "curies": [ { "name": "fx", "href": "https://api.foxycart.com/rels/{rel}", "templated": true } ], "self": { "href": "https://api.foxycart.com/users/1", "title": "This User" }, "fx:attributes": { "href": "https://api.foxycart.com/users/1/attributes", "title": "Attributes for This User" }, "fx:default_store": { "href": "https://api.foxycart.com/stores/66", "title": "Example Store" }, "fx:stores": { "href": "https://api.foxycart.com/users/1/stores", "title": "Stores for This User" } }, "first_name": "John", "last_name": "Doe", "email": "john.doe@example.com", "phone": "555-555-5555", "affiliate_id": 0, "is_programmer": true, "is_front_end_developer": false, "is_designer": false, "is_merchant": true, "date_created": "2007-05-23T16:09:12-0700", "date_modified": "2013-07-10T22:37:49-0700" }
<?xml version="1.0" encoding="UTF-8"?> <resource href="https://api.foxycart.com/users/1" rel="https://api.foxycart.com/rels/user"> <link rel="self" href="https://api.foxycart.com/users/1" title="This User"/> <link rel="https://api.foxycart.com/rels/attributes" href="https://api.foxycart.com/users/1/attributes" title="Attributes for This User"/> <link rel="https://api.foxycart.com/rels/default_store" href="https://api.foxycart.com/stores/66" title="Example Store"/> <link rel="https://api.foxycart.com/rels/stores" href="https://api.foxycart.com/users/1/stores" title="Stores for This User"/> <first_name>John</first_name> <last_name>Doe</last_name> <email>john.doe@example.com</email> <phone>555-555-5555</phone> <affiliate_id>0</affiliate_id> <is_programmer>true</is_programmer> <is_front_end_developer>false</is_front_end_developer> <is_designer>false</is_designer> <is_merchant>true</is_merchant> <date_created>2007-05-23T16:09:12-0700</date_created> <date_modified>2013-07-10T22:37:49-0700</date_modified> </resource>
{ "class": [ "user" ], "properties": { "first_name": "John", "last_name": "Doe", "email": "john.doe@example.com", "phone": "555-555-5555", "affiliate_id": 0, "is_programmer": true, "is_front_end_developer": false, "is_designer": false, "is_merchant": true, "date_created": "2007-05-23T16:09:12-0700", "date_modified": "2013-07-10T22:37:49-0700" }, "links": [ { "rel": [ "self" ], "href": "https://api.foxycart.com/users/1" }, { "rel": [ "https://api.foxycart.com/rels/attributes" ], "href": "https://api.foxycart.com/users/1/attributes" }, { "rel": [ "https://api.foxycart.com/rels/default_store" ], "href": "https://api.foxycart.com/stores/66" }, { "rel": [ "https://api.foxycart.com/rels/stores" ], "href": "https://api.foxycart.com/users/1/stores" } ] }
Zoomable Resources
This resource has no linked resources which can be "zoomed" in on, filtered and embedded within this resource.