ImportContact
One contact as the API accepts it (contactSchema in api-server/src/contact-input.ts). Adding is an upsert on the address: an existing person joins the list, names are overwritten only by a non-empty value, tags are added (never removed) and attributes merge key by key.
Properties
| Name | Type | Description |
|---|---|---|
| string | Stored trimmed and lower-cased. | |
| first_name | string | |
| last_name | string | |
| tags | array | Added to the person's existing tags. Lower-cased and trimmed; whitespace runs become a hyphen. |
| attributes | object | Custom property values by key; each value a string, number or boolean. Keys cannot be empty, contain "." or a null character, or start with "$"; such a key is refused with 422 (message starting "attri |
| status | string | Standing with the previous sender. unsubscribed sets the flag and writes a marketing-scoped suppression; bounced and complained set the flag and suppress all mail. Any of the three also cancels pendin |
| unsubscribed | boolean | true is a synonym for status: unsubscribed. Ignored when status is sent. |
| last_active_at | string | When the person was last active in your product, with a time zone. Counted by a segment's engaged_within_days. Kept only if later than the stored value; more than a day ahead is refused. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/sendraven-ai/json-schema/sendraven-ai-import-contact-schema.json",
"title": "ImportContact",
"description": "One contact as the API accepts it (contactSchema in api-server/src/contact-input.ts). Adding is an upsert on the address: an existing person joins the list, names are overwritten only by a non-empty value, tags are added (never removed) and attributes merge key by key.",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/sendraven-ai-audiences-api-openapi.yml#/components/schemas/ImportContact",
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"description": "Stored trimmed and lower-cased."
},
"first_name": {
"type": "string",
"maxLength": 120
},
"last_name": {
"type": "string",
"maxLength": 120
},
"tags": {
"type": "array",
"maxItems": 50,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"description": "Added to the person's existing tags. Lower-cased and trimmed; whitespace runs become a hyphen."
},
"attributes": {
"type": "object",
"additionalProperties": {
"oneOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
},
"propertyNames": {
"minLength": 1,
"pattern": "^(?!\\$)[^.\\u0000]+$"
},
"description": "Custom property values by key; each value a string, number or boolean. Keys cannot be empty, contain \".\" or a null character, or start with \"$\"; such a key is refused with 422 (message starting \"attributes:\") before anything is written. Each value is coerced to the type of its declared contact property (GET /v1/contact-properties). A key with no declared property creates one with type string, and its value is then stored as a string (5 becomes \"5\"): declare number and boolean properties before importing."
},
"status": {
"type": "string",
"enum": [
"subscribed",
"unsubscribed",
"bounced",
"complained"
],
"default": "subscribed",
"description": "Standing with the previous sender. unsubscribed sets the flag and writes a marketing-scoped suppression; bounced and complained set the flag and suppress all mail. Any of the three also cancels pending scheduled sends and ends active automation enrolments. An add never resubscribes: subscribed leaves an already-unsubscribed contact as it is."
},
"unsubscribed": {
"type": "boolean",
"description": "true is a synonym for status: unsubscribed. Ignored when status is sent."
},
"last_active_at": {
"type": "string",
"format": "date-time",
"description": "When the person was last active in your product, with a time zone. Counted by a segment's engaged_within_days. Kept only if later than the stored value; more than a day ahead is refused."
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/json-schemas/sendraven-ai-import-contact"
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.