Contacts

Create and update contacts with links and labels

Create or update contact

post

Create a new contact or update an existing contact. The contact is identified by email address. This endpoint is primarily intended for use with an external CRM or tool. For example, you can use this to annotate contacts in Jelly with links to internal account tools, subscription pages and so on.

Authorizations

BearerAuth

AuthorizationstringRequired

API token authentication. Include your token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

To get an API token:

1. Go to your team settings in Jelly
2. Navigate to "API Tokens"
3. Create a new token and save it securely

Body

application/json

emailstring · emailRequired

Contact email address (case-insensitive)

Example: [email protected]

namestringOptional

Contact name

Example: John Doe

Responses

200

Contact updated successfully

application/json

201

Contact created successfully

application/json

401

Missing or invalid API token

application/json

422

Validation error

application/json

500

Internal server error

application/json

post

/contacts

HTTPcURLJavaScriptPython

POST /api/contacts HTTP/1.1
Host: app.letsjelly.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 165

{
  "email": "[email protected]",
  "name": "John Doe",
  "links": [
    {
      "title": "LinkedIn",
      "url": "https://linkedin.com/in/johndoe"
    },
    {
      "title": "Website",
      "url": "https://johndoe.com"
    }
  ]
}

{
  "id": 42,
  "email": "[email protected]",
  "name": "John Doe",
  "links": [
    {
      "title": "LinkedIn",
      "url": "https://linkedin.com/in/johndoe"
    }
  ]
}