{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/custom-cards/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Custom Body","description":"Start building with the Dixa API","siteUrl":"https://docs.dixa.io/","keywords":"dixa developer hub, api portal starter, api reference docs","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"custom-body","__idx":0},"children":["Custom Body"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["DELETE, POST, and PUT methods require a body, and those can be multiple lines long because of the mandatory input, like our own ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.dixa.io/openapi/dixa-api/v1/tag/Conversations/#tag/Conversations/operation/postConversations"},"children":["Create Conversation"]},". When editing a custom card, there's a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body"]}," tab to help with the problem."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/body.aa4dd6f7e679f25a144138d3a5c9ad9f720906487959ebea4dddfb3a2a46fa67.fcd6b147.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is the Dixa example of a request to create a conversation using the curl command."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"curl -i -X POST https://dev.dixa.io/v1/conversations \\\n  -H 'Authorization: YOUR_API_KEY_HERE' \\\n  -H 'Content-Type: application/json' \\\n  -d @- <<'EOF'\n{\n    \"requesterId\": \"9c2a2cce-699f-4a72-89d9-fda5bc8dec8b\",\n    \"emailIntegrationId\": \"my-integration@email.dixa.io\",\n    \"subject\": \"order #123\",\n    \"message\": {\n        \"content\": {\n            \"value\": \"My order hasn't shipped\",\n            \"_type\": \"Text\"\n        },\n        \"attachments\": [],\n        \"_type\": \"Inbound\"\n    },\n    \"language\": \"en\",\n    \"_type\": \"Email\"\n}\nEOF\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The -d parameter indicates the body of the request. In this example, it is a JSON string, but it is possible to specify a body type in other formats, like plain text, CSV, HTML and form URL encoded."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The body type should be selected accordingly in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Content-Type"]}," field."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Following this example, you must select \"application/json\" in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Content Type"]}," dropdown and then insert the request in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body"]}," field the content between single quotes that come after the body (-d) parameter of the curl request (i.e. taking everything starting from the first curly bracket {...} to the last, brackets included)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Additionally, you can use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/custom-cards/placeholders"},"children":["placeholders"]}," to have dynamic bodies."]}]},"headings":[{"value":"Custom Body","id":"custom-body","depth":1}],"frontmatter":{"seo":{"title":"Custom Body"}},"lastModified":"2026-04-09T11:32:42.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/custom-cards/custom-body","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}