Create a signal

POST

https://api.middesk.com/v1/signals

POST

/v1/signals

1 import requests
2 
3 url = "https://api.middesk.com/v1/signals"
4 
5 payload = {
6     "name": "Acme Corporation",
7     "addresses": ["123 Main Street, San Francisco, CA 94105"],
8     "tin": "12-3456789",
9     "external_id": "ext-12345",
10     "model_slug": "verify"
11 }
12 headers = {
13     "Authorization": "Basic <username>:<password>",
14     "Content-Type": "application/json"
15 }
16 
17 response = requests.post(url, json=payload, headers=headers)
18 
19 print(response.json())

Try it

201Signal request

1 {
2   "object": "signal",
3   "id": "f6a7b8c9-d0e1-2345-f012-3456789abcde",
4   "created_at": "2025-01-07T12:00:00.000Z",
5   "external_id": "ext-12345",
6   "name": "Acme Corporation",
7   "tin": "12-3456789",
8   "addresses": [
9     "123 Main Street, San Francisco, CA 94105"
10   ],
11   "batch_id": "a7b8c9d0-e1f2-3456-0123-456789abcdef",
12   "score": 0.85,
13   "model_slug": "verify",
14   "requester": {
15     "id": "b8c9d0e1-f2a3-4567-1234-56789abcdef0",
16     "type": "Account",
17     "name": "Example Account"
18   },
19   "reasons": [
20     {
21       "category": "identity",
22       "group": "name",
23       "description": "Business name verified",
24       "code": "V101"
25     }
26   ]
27 }

Authentication

AuthorizationBasic

Basic authentication of the form Basic <username:password>.

Request

This endpoint expects an object.

namestringRequired

Company name

addresseslist of stringsRequired

Array of addresses

tinstringOptional

Tax identification number

external_idstringOptional

External identifier

model_slugstringOptional

Scoring model slug

peoplelist of stringsOptional

Array of people names

Response

signal created

Authentication

Request

Response

Errors