Users API

The Users API allows you to manage user data in your SMASHSEND account. You can retrieve user information, create new users, and update existing users.

Endpoints

GET/v1/users/me

Retrieves information about the authenticated user.

Authentication

Requires a valid API key with user scope.

Request

curl https://api.smashsend.com/v1/users/me \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "user": {
    "id": "usr_123456789",
    "email": "user@example.com",
    "name": "Example User",
    "createdAt": "2023-01-01T12:00:00Z",
    "lastAccessedAt": "2023-04-15T09:30:00Z"
  }
}

POST/v1/users

Creates a new user.

Authentication

Requires a valid API key with user scope.

Request Body

{
    "email": "newuser@example.com",
    "name": "New User"
  }

Request

curl -X POST https://api.smashsend.com/v1/users \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "newuser@example.com",
    "name": "New User"
  }'

Response

{
  "user": {
    "id": "usr_987654321",
    "email": "newuser@example.com",
    "name": "New User",
    "createdAt": "2023-04-16T15:45:00Z",
    "lastAccessedAt": "2023-04-16T15:45:00Z"
  }
}

PUT/v1/users/me

Updates the authenticated user's information.

Authentication

Requires a valid API key with user scope.

Request Body

{
    "name": "Updated User Name"
  }

Request

curl -X PUT https://api.smashsend.com/v1/users/me \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated User Name"
  }'

Response

{
  "user": {
    "id": "usr_123456789",
    "email": "user@example.com",
    "name": "Updated User Name",
    "createdAt": "2023-01-01T12:00:00Z",
    "lastAccessedAt": "2023-04-16T16:20:00Z"
  }
}