Account

Create account

POST/api/v1/auth/create-account

Creates a new SwiftGoma account and emails a 6-character verification code to confirm ownership of the address. The account is unusable for login until the email is verified.

No authentication required

Account creation — tightly limited per IP

Body parameters

`name`stringrequired	Full name shown on the account.
`email`stringrequired	Email address to verify and use for login.
`role`string	One of BUYER, SELLER, RIDER. Defaults to BUYER.
`locale`string	en or fr — controls the verification email language. Defaults to en.

Possible errors

422	VALIDATION_ERROR	Cette adresse e-mail est déjà utilisée.
429	TOO_MANY_REQUESTS	Trop de tentatives. Veuillez ralentir.

Notes

Submitting the same unverified email again resends a new code instead of creating a duplicate account.
Requests are screened for automated/bot traffic before hitting the rate limiter.

Request

curl --request POST \
  --url https://api.swiftgoma.com/api/v1/auth/create-account \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Aline Mapendo",
  "email": "aline@example.com",
  "role": "BUYER",
  "locale": "fr"
}'

201Example response

{
  "success": true,
  "data": {
    "id": "3f2a1c9e-7b41-4e2a-9c31-8e6b2d4f10aa",
    "name": "Aline Mapendo",
    "role": "BUYER",
    "email": "aline@example.com",
    "isEmailVerified": false,
    "phone": "243812345678",
    "isPhoneVerified": false,
    "createdAt": "2026-01-14T10:32:00.000Z"
  }
}