Create a new contact account for a customer

Add a new contact person to an existing customer account, creating a new system record and returning a unique contact ID for permission management.

Account & Settings Account

Context

Used in the dashboard

/teams

Workflow links

Produces

contact_id → data.contact_id

GET /api/contacts/{contactId}/permissions
POST /api/contacts/{contactId}/permissions

Related endpoints

GET /api/teams Get teams and contacts associated with your account DELETE /api/teams Delete a team or contact from your account PUT /api/teams Update your account contact information

Headers

Accept Example

Content-Type Example

Body

required

application/json

address1 string required · Example:

city string required · Example:

country string required · Example:

email string required · Example: [email protected]

firstname string required · Example: Anna

lastname string required · Example: Svensson

password string required · Example: YOUR_PASSWORD

phonenumber string required · Example:

postcode string required · Example:

type string required · Example: contact

Responses

200

data object required

data.call string · Example: addClientContact

data.contact_id integer · Example: 14087

data.error string · Example: Failed to add contact

HTTP status title (e.g. 'Bad Request').

data.server_time integer · Example: 1769765937

data.success boolean · Example: true

True for successful responses.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

POST https://cloud.hostup.se/api/teams

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/teams" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "contact",
    "firstname": "Anna",
    "lastname": "Svensson",
    "email": "[email protected]",
    "password": "YOUR_PASSWORD",
    "phonenumber": "",
    "address1": "",
    "city": "",
    "country": "",
    "postcode": ""
  }'

Response

{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "success": true,
    "contact_id": 14087,
    "call": "addClientContact",
    "server_time": 1769765937
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "call": {
          "type": "string"
        },
        "contact_id": {
          "type": "integer"
        },
        "error": {
          "type": "string",
          "description": "HTTP status title (e.g. 'Bad Request')."
        },
        "server_time": {
          "type": "integer"
        },
        "success": {
          "type": "boolean",
          "description": "True for successful responses."
        }
      }
    },
    "requestId": {
      "type": "string",
      "description": "Unique request identifier (UUID)."
    },
    "success": {
      "type": "boolean",
      "description": "True for successful responses."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 timestamp (UTC)."
    }
  }
}

Request Body contact

{
  "type": "contact",
  "firstname": "Anna",
  "lastname": "Svensson",
  "email": "[email protected]",
  "password": "YOUR_PASSWORD",
  "phonenumber": "",
  "address1": "",
  "city": "",
  "country": "",
  "postcode": ""
}