CreateActivityForUserWithNumbers

Creates a new activity (fee) for a specific user. This mutation allows tracking time spent on various tasks & cost recovery records across matters and phases, with support for both billable and non-billable entries.

Mutation Structure

Mutation Name: CreateActivityForUserWithNumbers

Input Type: CreateActivityForUserWithNumbers! - Required input object

Return Type: Activity - The created activity object

Input Parameters

The mutation requires a CreateActivityForUserWithNumbers input object with the following fields:

UserEmail: String! - Email address of the user for which the activity is assigned
ApplicableDate: String! - Date when the activity occurred (format: YYYY-MM-DD)
MatterNumber: String! - Reference number of the matter
MatterPhaseNumber: String! - Reference number of the matter phase
ActivityTypeNumber: String! - Reference number of the activity type
UnitNumber: String! - Reference number of the unit (e.g. hours, pages)
Description: String! - Detailed description of the activity performed
BillableQuantity: Float! - Number of billable units spent
NonBillableQuantity: Float! - Number of non-billable units spent

Example Usage

cURL


curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "query": "mutation CreateActivity($input: CreateActivityForUserWithNumbers!) { CreateActivityForUserWithNumbers(createActivityForUserWithNumbers: $input) { Id } }",
    "variables": {
      "input": {
        "UserEmail": "john.doe@company.com",
        "ApplicableDate": "2023-11-15",
        "MatterNumber": "MAT-2023-001",
        "MatterPhaseNumber": "PH-2023-001-A",
        "ActivityTypeNumber": "ACT-001",
        "UnitNumber": "UNIT-001",
        "Description": "Conducted legal research on corporate restructuring regulations",
        "BillableQuantity": 3.5,
        "NonBillableQuantity": 1.0
      }
    }
  }' \
  https://sandbox.drivepractice.com/api/v1/graphql

C#


using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json;
 
class Program
{
    static async Task Main(string[] args)
    {
        var url = "https://sandbox.drivepractice.com/api/v1/graphql";
        var token = "YOUR_ACCESS_TOKEN";
 
        var query = @"
        mutation CreateActivity($input: CreateActivityForUserWithNumbers!) {
          CreateActivityForUserWithNumbers(createActivityForUserWithNumbers: $input) {
            Id
          }
        }";
 
        var variables = new
        {
            input = new
            {
                UserEmail = "john.doe@company.com",
                ApplicableDate = "2023-11-15",
                MatterNumber = "MAT-2023-001",
                MatterPhaseNumber = "PH-2023-001-A",
                ActivityTypeNumber = "ACT-001",
                UnitNumber = "UNIT-001",
                Description = "Conducted legal research on corporate restructuring regulations",
                BillableQuantity = 3.5,
                NonBillableQuantity = 1.0
            }
        };
 
        var payload = new
        {
            query = query,
            variables = variables
        };
 
        using var httpClient = new HttpClient();
        httpClient.DefaultRequestHeaders.Authorization =
            new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", token);
 
        var content = new StringContent(JsonConvert.SerializeObject(payload), Encoding.UTF8, "application/json");
        var response = await httpClient.PostAsync(url, content);
        var responseString = await response.Content.ReadAsStringAsync();
 
        dynamic result = JsonConvert.DeserializeObject(responseString);
        if (result.errors != null)
        {
            Console.WriteLine("Error: " + result.errors[0].message);
        }
        else
        {
            Console.WriteLine("Activity created with ID: " + result.data.CreateActivityForUserWithNumbers.Id);
        }
    }
}

VB.NET


Imports System.Net.Http
Imports System.Text
Imports Newtonsoft.Json
 
Module Module1
    Sub Main()
        Dim url As String = "https://sandbox.drivepractice.com/api/v1/graphql"
        Dim token As String = "YOUR_ACCESS_TOKEN"
 
        Dim query As String = "
        mutation CreateActivity($input: CreateActivityForUserWithNumbers!) {
          CreateActivityForUserWithNumbers(createActivityForUserWithNumbers: $input) {
            Id
          }
        }"
 
        Dim variables As New With {
            .input = New With {
                .UserEmail = "john.doe@company.com",
                .ApplicableDate = "2023-11-15",
                .MatterNumber = "MAT-2023-001",
                .MatterPhaseNumber = "PH-2023-001-A",
                .ActivityTypeNumber = "ACT-001",
                .UnitNumber = "UNIT-001",
                .Description = "Conducted legal research on corporate restructuring regulations",
                .BillableQuantity = 3.5,
                .NonBillableQuantity = 1.0
            }
        }
 
        Dim payload As New With {
            .query = query,
            .variables = variables
        }
 
        Dim httpClient As New HttpClient()
        httpClient.DefaultRequestHeaders.Authorization = New Http.Headers.AuthenticationHeaderValue("Bearer", token)
 
        Dim content As New StringContent(JsonConvert.SerializeObject(payload), Encoding.UTF8, "application/json")
        Dim response As HttpResponseMessage = httpClient.PostAsync(url, content).Result
        Dim responseString As String = response.Content.ReadAsStringAsync().Result
 
        Dim result As Object = JsonConvert.DeserializeObject(Of Object)(responseString)
        If TypeOf result Is Dictionary(Of String, Object) Then
            Dim dict As Dictionary(Of String, Object) = DirectCast(result, Dictionary(Of String, Object))
            If dict.ContainsKey("errors") Then
                Console.WriteLine("Error: " + DirectCast(dict("errors"), List(Of Object))(0).ToString())
            ElseIf dict.ContainsKey("data") Then
                Dim data As Dictionary(Of String, Object) = DirectCast(dict("data"), Dictionary(Of String, Object))
                Dim activityData As Dictionary(Of String, Object) = DirectCast(data("CreateActivityForUserWithNumbers"), Dictionary(Of String, Object))
                Console.WriteLine("Activity created with ID: " + activityData("Id").ToString())
            End If
        End If
    End Sub
End Module

JavaScript


import { request } from 'graphql-request';
 
const mutation = `
  mutation CreateActivity($input: CreateActivityForUserWithNumbers!) {
    CreateActivityForUserWithNumbers(createActivityForUserWithNumbers: $input) {
      Id
    }
  }
`;
 
const variables = {
  input: {
    UserEmail: "john.doe@company.com",
    ApplicableDate: "2023-11-15",
    MatterNumber: "MAT-2023-001",
    MatterPhaseNumber: "PH-2023-001-A",
    ActivityTypeNumber: "ACT-001",
    UnitNumber: "UNIT-001",
    Description: "Conducted legal research on corporate restructuring regulations",
    BillableQuantity: 3.5,
    NonBillableQuantity: 1.0
  }
};
 
const data = await request(
  'https://sandbox.drivepractice.com/api/v1/graphql',
  mutation,
  variables,
  {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
  }
);
 
console.log('Activity created with ID:', data.CreateActivityForUserWithNumbers.Id);

Python


import requests
import json
 
url = 'https://sandbox.drivepractice.com/api/v1/graphql'
headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
}
 
query = """
mutation CreateActivity($input: CreateActivityForUserWithNumbers!) {
  CreateActivityForUserWithNumbers(createActivityForUserWithNumbers: $input) {
    Id
  }
}
"""
 
variables = {
    "input": {
        "UserEmail": "jane.smith@company.com",
        "ApplicableDate": "2023-11-16",
        "MatterNumber": "MAT-2023-002",
        "MatterPhaseNumber": "PH-2023-002-A",
        "ActivityTypeNumber": "ACT-002",
        "UnitNumber": "UNIT-002",
        "Description": "Client meeting to discuss compliance requirements",
        "BillableQuantity": 2.0,
        "NonBillableQuantity": 0.5
    }
}
 
payload = {
    "query": query,
    "variables": variables
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()
 
if 'errors' in data:
    print("Error:", data['errors'])
else:
    print("Activity created with ID:", data['data']['CreateActivityForUserWithNumbers']['Id'])

Example Response

Success Response


{
  "data": {
    "CreateActivityForUserWithNumbers": {
      "Id": "5f8d0d5a7b3e4f1234567897"
    }
  }
}

Response with Full Activity Details

To retrieve more details about the created activity, you can request additional fields:


curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "query": "mutation CreateActivity($input: CreateActivityForUserWithNumbers!) { CreateActivityForUserWithNumbers(createActivityForUserWithNumbers: $input) { Id } }",
    "variables": {
      "input": {
        "UserEmail": "john.doe@company.com",
        "ApplicableDate": "2023-11-15",
        "MatterNumber": "MAT-2023-001",
        "MatterPhaseNumber": "PH-2023-001-A",
        "ActivityTypeNumber": "ACT-001",
        "UnitNumber": "UNIT-001",
        "Description": "Conducted legal research on corporate restructuring regulations",
        "BillableQuantity": 3.5,
        "NonBillableQuantity": 1.0
      }
    }
  }' \
  https://sandbox.drivepractice.com/api/v1/graphql

Error Handling

Common Error Responses

Missing Required Fields:


{
  "errors": [
    {
      "message": "Field 'UserEmail' of required type 'String!' was not provided.",
      "locations": [
        {
          "line": 2,
          "column": 3
        }
      ],
      "extensions": {
        "code": "GRAPHQL_VALIDATION_FAILED"
      }
    }
  ]
}

Invalid Email Format:


{
  "errors": [
    {
      "message": "UserEmail must be a valid email address",
      "extensions": {
        "code": "BAD_USER_INPUT"
      }
    }
  ]
}

Unauthorized Access:


{
  "errors": [
    {
      "message": "Unauthorized",
      "extensions": {
        "code": "UNAUTHENTICATED"
      }
    }
  ]
}

Server Error:


{
  "errors": [
    {
      "message": "Internal server error",
      "extensions": {
        "code": "INTERNAL_SERVER_ERROR"
      }
    }
  ]
}

Best Practices

Date Format: Always use ISO 8601 format (YYYY-MM-DD) for the ApplicableDate field
Time Tracking: Ensure that BillableQuantity and NonBillableQuantity are non-negative numbers
Descriptions: Provide detailed descriptions for better time tracking and reporting
Error Handling: Implement proper error handling in your client applications to handle validation errors gracefully
Authentication: Always include a valid authorization token in the request headers

Validation Rules

All fields in the input object are required (marked with !)
UserEmail must be a valid email format
ApplicableDate must be a valid date
BillableQuantity and NonBillableQuantity must be non-negative numbers
The user must have appropriate permissions to create activities