POST
/
login
Header
curl --request POST \
  --url https://sandbox-api.violet.io/v1/login
{
  "id": 123,
  "first_name": "<string>",
  "last_name": "<string>",
  "password": "<string>",
  "email": "<string>",
  "type": "ADMIN",
  "verified": true,
  "status": "INACTIVE",
  "date_created": "2023-11-07T05:31:56Z",
  "date_last_modified": "2023-11-07T05:31:56Z",
  "roles": [
    {
      "name": "<string>",
      "permissions": []
    }
  ],
  "tos_accepted": true,
  "payment_configured": true,
  "privacy_policy_accepted": true,
  "country_code": "US",
  "token": "<string>",
  "refresh_token": "<string>",
  "merchant_id": 123,
  "merchant_ids": [
    123
  ],
  "store_url": "<string>"
}

Login to Violet using your App Secret and App Id, retrieved from channel.violet.io. This is required to receive an App Token, which is used to authenticate requests made to violet.

Headers

X-Violet-App-Secret
string
X-Violet-App-Id
integer

Response

200 - application/json
id
integer
first_name
string
required

The users first name

last_name
string
required

The users last name

password
string
required

The users raw desired password

email
string
required

The users unique email address

type
enum<string>
required

The allowed values for the user type

Available options:
ADMIN,
MERCHANT,
USER,
DEVELOPER,
INFLUENCER
verified
boolean

If a user has verified their emailed address

status
enum<string>

The status of the user

Available options:
INACTIVE,
ACTIVE,
DISABLED
date_created
string

Date of creation

date_last_modified
string

Date of last update

roles
object[]
tos_accepted
boolean

Terms of Service Accepted

payment_configured
boolean

Is the Users Payment Settings Configured

privacy_policy_accepted
boolean

Privacy Policy Accepted

country_code
enum<string>

Country Code

Available options:
US,
AU,
AT,
BE,
CA,
DK,
FI,
FR,
DE,
HK,
IE,
IT,
JP,
LU,
MX,
NL,
NZ,
NO,
PT,
SG,
ES,
SE,
CH,
GB,
AF,
AX,
AL,
DZ,
AS,
AD,
AO,
AI,
AQ,
AG,
AR,
AM,
AW,
AZ,
BS,
BH,
BD,
BB,
BY,
BZ,
BJ,
BM,
BT,
BO,
BA,
BW,
BV,
BR,
IO,
BN,
BG,
BF,
BI,
KH,
CM,
CV,
KY,
CF,
TD,
CL,
CN,
CX,
CC,
CO,
KM,
CG,
CD,
CK,
CR,
CI,
HR,
CU,
CY,
CZ,
DJ,
DM,
DO,
EC,
EG,
SV,
GQ,
ER,
EE,
ET,
FK,
FO,
FJ,
GF,
PF,
TF,
GA,
GM,
GE,
GH,
GI,
GR,
GL,
GD,
GP,
GU,
GT,
GG,
GN,
GW,
GY,
HT,
HM,
VA,
HN,
HU,
IS,
IN,
ID,
IR,
IQ,
IM,
IL,
JM,
JE,
JO,
KZ,
KE,
KI,
KP,
KR,
KW,
KG,
LA,
LV,
LB,
LS,
LR,
LY,
LI,
LT,
MO,
MK,
MG,
MW,
MY,
MV,
ML,
MT,
MH,
MQ,
MR,
MU,
YT,
FM,
MD,
MC,
MN,
ME,
MS,
MA,
MZ,
MM,
NA,
NR,
NP,
AN,
NC,
NI,
NE,
NG,
NU,
NF,
MP,
OM,
PK,
PW,
PS,
PA,
PG,
PY,
PE,
PH,
PN,
PL,
PR,
QA,
RE,
RO,
RU,
RW,
SH,
KN,
LC,
PM,
VC,
WS,
SM,
ST,
SA,
SN,
RS,
SC,
SL,
SK,
SI,
SB,
SO,
ZA,
GS,
LK,
SD,
SR,
SJ,
SZ,
SY,
TW,
TJ,
TZ,
TH,
TL,
TG,
TK,
TO,
TT,
TN,
TR,
TM,
TC,
TV,
UG,
UA,
AE,
UM,
UY,
UZ,
VU,
VE,
VN,
VG,
VI,
WF,
EH,
YE,
ZM,
ZW
token
string

Token

refresh_token
string

Refresh Token

merchant_id
integer

Merchant ID

merchant_ids
integer[]

Merchant IDs

store_url
string

Store Url

Was this page helpful?

WelcomeRefresh Token