DecisionVault API
  1. Matters
DecisionVault API
  • DecisionVault API
    • Authentication
    • Automation
    • External Identifiers
    • Financial Categories
    • Pagination
    • Webhooks
    • Questionnaires
      • Get Questionnaires
      • Get Single Questionnaire
    • FinancialCategories
      • Get Financial Categories
    • Matters
      • Get Matters
        GET
      • Get Single Matter
        GET
      • Get Clients for a Matter
        GET
      • Get Assets for a Matter
        GET
      • Get Contacts for a Matter
        GET
      • Get Documents for Matter
        GET
      • Get Financial Documents for Matter
        GET
      • Create Matter
        POST
    • Events
      • Get Events
      • Get Single Event
    • Documents
      • Get Single Document
    • Users
      • Get Single User
    • Subscriptions
      • Create Webhook Subscription
      • Delete Webhook Subscription
  1. Matters

Create Matter

POST
/v1/matters/create
The endpoint allowes you to 'pre create' a matter in DecisionVault, and get back an invite_key + invite_url
(see the article on 'automation' for more information on how this works.)
The context object can have up to 5 key/value pairs, where the value can be of type string or int. Nested JSON objects are not supported.

Request

Body Params application/json

Examples

Responses

🟢201Created
application/json
Created
Body

🟠401Unauthorized
🟠403Forbidden
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1/matters/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "questionnaire_id": "quest_AAABBBCCCDDDEEEFFFFF00112233",
    "matter_name": "02849 - Smith",
    "context": {
        "one-system-id": 2944938,
        "two-system-id": "d2ae160b-08e7-4d83"
    }
}'
Response Response Example
{
    "id": "matter_AABBCCDD0011223344",
    "invite_key": "sdxuarqwfi7do072qrnmqoj2rw6sgvfpezjd9wco3fbe3kl",
    "invite_url": "https://app.decisionvault.com/start/lawfirm/sdxuarqwfi7do072qrnmqoj2rw6sgvfpezjd9wco3fbe3kl"
}
Modified at 2025-09-18 21:00:45
Previous
Get Financial Documents for Matter
Next
Get Events
Built with