Create contact
Add a customer, supplier or other contact, as a person or an organization.
POST https://cotlet.dev/api/v1/sevdesk/contacts
write
Creates a contact like the Kontakt erstellen button does. sevdesk knows persons and organizations; set kind and give name for an organization or first_name and last_name for a person. The category is Kunde, Lieferant, Partner, Interessent or one you created. create_contact sends nothing to anyone and runs without asking first: a new contact only appears in your own Kontakte list.
Parameters
| Name | Type | Description |
|---|---|---|
| kind enum required | enum | organization or person. |
| name string | string | Organization name. Required for kind organization. |
| first_name string | string | First name. For kind person. |
| last_name string | string | Last name. Required for kind person. |
| category string | string | Category name, e.g. Kunde or Lieferant. Default: Kunde. |
| email string | string | Email address; needed later to send invoices and e-invoices. |
| street string | string | Street and house number. |
| zip string | string | Postal code. |
| city string | string | City. |
| country string | string | Country name or ISO code. Default: Germany. |
Request
curl -X POST https://cotlet.dev/api/v1/sevdesk/contacts \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kind":"organization"}'result = client.call("sevdesk", "create_contact", {"kind":"organization"})const result = await cotlet.call('sevdesk', 'create_contact', {"kind":"organization"});cotlet call sevdesk create_contact --data '{"kind":"organization"}'Example response
{
"contact_id": "3084417",
"kind": "organization",
"name": "Nordlicht Studio",
"category": "Kunde",
"customer_number": "1017"
}