Workspace

Add a share to a record

multipart/form-data: a note and up to 10 files (15 MB each; allowed types as for web attachments) on the chosen record. Subject, sender, date and body of .eml files go into the note; the note ends with shared from phone. Rejected files are listed in warnings. kind: customer, opp, ticket, contract or contact (to the contact's company). Advanced / Enterprise plans only.

POST/api/v1/share

Authorization

Authorizationheaderrequired

Bearer token: API key (sk_…), OAuth access token (mcp_…) or mobile session (xk_…).

Scope: crm.write

Body application/json

kindstringrequired

Record type.

Valuescustomeroppticketcontractcontact

idintegerrequired

Record id.

titlestringoptional

Note title.

textstringoptional

Note text.

filesfile[]optional

Files (max 10).

Errors

HTTP	error	Meaning
`400`	`invalid`	Missing or invalid field (`message` explains).
`400`	`empty`	empty
`403`	`plan`	plan
`404`	`not_found`	Record not found.

Request

curl -X POST https://ornek.solk.app/api/v1/share \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/share", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
  },
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/share",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
)
print(r.json())

Response