Creating users

The User object represents the data you can send to Signitic.

You can send up to 100 users per API batch.

Endpoint

POST https://api.signitic.app/users

Headers

Name	Type	Description
x-api-key*	String	Your API key

POST /users creates new users and also updates existing users matched by email.

Request body

Example

{
  "users": [
    {
      "email": "[email protected]",
      "enabled": true,
      "path": {
        "group": "Marketing Direction",
        "parent_entity": "Company",
        "entity": "Paris Office"
      },
      "firstname": "Johanna",
      "lastname": "Doe",
      "phone": "[phone]",
      "mobile": "[phone]",
      "department": "Marketing",
      "jobtitle": "CEO",
      "formula": "Kind regards,<br/>John",
      "vcard_user": true,
      "calendar_link": "calendar.com",
      "github_link": "github.com",
      "linkedin_link": "linkedin.com",
      "whatsapp_link": "whatsapp.com",
      "facebook_link": "facebook.com",
      "instagram_link": "instagram.com",
      "twitter_link": "twitter.com",
      "xing_link": "xing.com",
      "messenger_link": "messenger.com",
      "threads_link": "threads.net",
      "strava_link": "strava.com",
      "address": "1600 Pennsylvania Avenue NW<br/>Washington, DC 20500,<br/>USA",
      "postal_code": "75008",
      "city": "Paris",
      "extra_1": "extra field 1",
      "extra_2": "extra field 2",
      "extra_10": "extra field 10",
      "extra_20": "extra field 20"
    }
  ]
}

Notes

• path.parent_entity is the preferred key. path.parent is still accepted for backward compatibility.

• extra_1 to extra_20 are supported.

• Social fields such as xing_link, messenger_link, threads_link, strava_link, and bluesky_link are accepted in the payload.

Success response

200 OK

{
  "success": true,
  "code": 200,
  "value": {
    "added": 1,
    "edited": 0
  }
}

Error responses

Status	Internal code	When
400	103	The request body is not valid JSON.
401	99	The API key is missing or invalid.
422	104	More than 100 users are sent in the batch.