> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.awardspring.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.awardspring.com/_mcp/server. # Create a donor activity log entry (call, meeting, email, note, or pledge). POST https://api.awardspring.com/api/v1/donors/{donorId}/activities Content-Type: application/json Records that an interaction with a donor took place — a call you just finished, a meeting, an email, a note, or a verbal pledge. Errors come back with a stable `code`, a readable `message`, and per-field `details`, so a caller can tell what to correct. Supported activity types: `LoggedEmail`, `LoggedPhone`, `LoggedMeeting`, `LoggedNote`, `LoggedPledge`. Gifts are recorded through the Gifts endpoints instead. A typical use is working through a call list and logging each conversation as it ends, with the summary and any follow-up owner attached. Set `dry_run=true` (query param or `Dry-Run: true` header) to validate without persisting. Idempotency: the request supports an optional `Idempotency-Key` header (any printable-ASCII string, 1–255 chars — UUIDs work well). When supplied, the same key + same request body within 24 hours returns the original response verbatim without creating a duplicate activity. The same key with a different body returns `422 idempotency_key_request_mismatch`; a concurrent retry while the first call is still executing returns `409 idempotency_key_in_flight`. Only 2xx responses are cached — 4xx/5xx leave the key available for retry with a corrected payload. Assistant capability: `springiq_create_activity`. Required permission: Donors (applies when called on behalf of a signed-in person). Reference: https://docs.awardspring.com/api-reference/donor-activities/create ## Authentication - `X-Spring-API-Key` header (required) — Secret API key issued per institution. Send it on every request. ## Servers - `https://api.awardspring.com` (UnitedStates, default) - `https://api.awardspring.ca` (Canada) ## Request ### Path parameters - `donorId` (string, required) — The stored ID of the donor (or donor organization) to attach the activity to. ### Body (application/json) This endpoint expects a CreateDonorActivityV1Request. - `activity_type` (enum, required, nullable) — The kind of activity being logged. Supported values: `LoggedEmail` — an email exchanged with the donor (manually logged after the fact). Example: `"LoggedEmail"`.`LoggedPhone` — a phone conversation with the donor. Example: `"LoggedPhone"`.`LoggedMeeting` — an in-person or virtual meeting. Example: `"LoggedMeeting"`.`LoggedNote` — a free-form note attached to the donor record. Example: `"LoggedNote"`.`LoggedPledge` — a recorded pledge of a future gift; requires Amount. Example: `"LoggedPledge"`. Gifts (`LoggedGift`) are not supported by this endpoint — they are recorded through a separate gift-entry flow. - Allowed values: `LoggedEmail`, `LoggedPhone`, `LoggedMeeting`, `LoggedNote`, `LoggedPledge` - `activity_date` (string, required, nullable) — ISO 8601 date or date-time the activity occurred (or is scheduled for, when in the future). A full date is required — examples: `"2026-04-03"`, `"2026-04-03T10:00:00Z"`, `"2026-04-03T10:00:00-05:00"`. Time-of-day is optional. The date is interpreted in the tenant's configured time zone and persisted in UTC. - `subject` (string, required, nullable) — Short human-readable title for the activity. Required, non-whitespace. Example: `"Quarterly stewardship call"`. Surfaced in donor activity lists in the AwardSpring admin UI. - `description` (string, optional, nullable) — Optional free-form details about the activity. Example: `"Discussed plans for the spring scholarship gala; donor expressed interest in funding a new STEM award."`. - `amount` (double, optional, nullable) — Monetary amount for pledge activities. Required and greater than zero when `activity_type` is `LoggedPledge`; ignored for non-monetary activity types. Example: `5000.00`. - `fund_id` (string, optional, nullable) — Optional fund identifier the pledge is directed toward. Only meaningful when ActivityType is `LoggedPledge`. When the tenant has Funds Management enabled, the value must match an existing fund's `FundIdName`; otherwise a `fund_not_found` error is returned. When Funds Management is disabled, the value is stored as a free-form label without validation. Example: `"GEN-2026"`. - `campaign_id` (string, optional, nullable) — Optional stored ID of a campaign at this institution, for pledge activities. Only meaningful when ActivityType is `LoggedPledge`; ignored for non-monetary activity types. Example: `"7HQ2KW9XR"`. - `assigned_to_user_id` (string, optional, nullable) — Optional stored ID of the staff member the activity is assigned to (e.g., the donor manager who should follow up). Pass `null` or omit when no assignment is intended. Example: `"4MZ8RT2PW"`. - `is_completed` (boolean, optional) — Whether the activity is completed. For non-monetary activity types this is ignored (treated as `false`). For `LoggedPledge`, `true` indicates the pledge has been fulfilled. Defaults to `false`. ## Response ### 201 Created - `object` (string, optional, nullable) — Stripe-style resource discriminator. Stable, snake_case string naming the resource type. Serialized first so it reads as the leading field of every V1 resource body. - `id` (string, optional, nullable) — The new activity's stored ID: 9 characters, the same ID the donor's timeline shows for it. A dry run returns `null`, because nothing was saved. - `activity_type` (string, optional, nullable) — Echo of the activity type that was saved (e.g. `"LoggedEmail"`, `"LoggedPledge"`). - `subject` (string, optional, nullable) — Echo of the saved `Subject`. - `description` (string, optional, nullable) — Echo of the saved `Description` (may be `null`). - `date` (integer, optional) — The activity date (UTC epoch seconds on the wire). - `amount` (double, optional, nullable) — Pledge amount, or `null` for non-monetary activity types. - `fund_id` (string, optional, nullable) — Fund identifier the pledge was directed toward, or `null` for non-monetary activity types. - `campaign_id` (string, optional, nullable) — The stored ID of the campaign the pledge belongs to, or `null` for non-monetary activity types. - `assigned_to_user_id` (string, optional, nullable) — The stored ID of the staff member the activity was assigned to, or `null` when not assigned. - `is_completed` (boolean, optional) — Completion flag — meaningful only for `LoggedPledge`. Always `false` for non-monetary types. ## Errors ### 400 Bad Request Error Bad Request - `error` (V1ErrorBody, optional) — Stripe-shaped error object for the `/api/v1/*` surface. Serialized snake\_case (via V1SnakeCaseNamingStrategy) and always nested under the `error` key of a V1ErrorEnvelope: `{ "error": { "type": "...", "code": "...", "message": "...", "param": null, "doc_url": null, "recovery": "..." } }` ### 404 Not Found Error Not Found - `error` (V1ErrorBody, optional) — Stripe-shaped error object for the `/api/v1/*` surface. Serialized snake\_case (via V1SnakeCaseNamingStrategy) and always nested under the `error` key of a V1ErrorEnvelope: `{ "error": { "type": "...", "code": "...", "message": "...", "param": null, "doc_url": null, "recovery": "..." } }` ### 409 Conflict Error Conflict - `error` (V1ErrorBody, optional) — Stripe-shaped error object for the `/api/v1/*` surface. Serialized snake\_case (via V1SnakeCaseNamingStrategy) and always nested under the `error` key of a V1ErrorEnvelope: `{ "error": { "type": "...", "code": "...", "message": "...", "param": null, "doc_url": null, "recovery": "..." } }` ### 422 Unprocessable Entity Error Unprocessable Content - `error` (V1ErrorBody, optional) — Stripe-shaped error object for the `/api/v1/*` surface. Serialized snake\_case (via V1SnakeCaseNamingStrategy) and always nested under the `error` key of a V1ErrorEnvelope: `{ "error": { "type": "...", "code": "...", "message": "...", "param": null, "doc_url": null, "recovery": "..." } }` ### 429 Too Many Requests Error Rate limit exceeded for this API key. Retry after the interval in the `Retry-After` header. - `error` (V1ErrorBody, optional) — Stripe-shaped error object for the `/api/v1/*` surface. Serialized snake\_case (via V1SnakeCaseNamingStrategy) and always nested under the `error` key of a V1ErrorEnvelope: `{ "error": { "type": "...", "code": "...", "message": "...", "param": null, "doc_url": null, "recovery": "..." } }` ## Types ### V1ErrorBody Stripe-shaped error object for the `/api/v1/*` surface. Serialized snake\_case (via V1SnakeCaseNamingStrategy) and always nested under the `error` key of a V1ErrorEnvelope: `{ "error": { "type": "...", "code": "...", "message": "...", "param": null, "doc_url": null, "recovery": "..." } }` - `type` (string, optional, nullable) — Coarse error category from V1ErrorType (e.g. `invalid_request_error`). - `code` (string, optional, nullable) — Stable fine-grained machine code from ErrorCode (e.g. `donor_not_found`). - `message` (string, optional, nullable) — Human-readable summary safe to surface to the caller. - `param` (string, optional, nullable) — The request parameter the error relates to, when attributable to a single field; otherwise null. - `doc_url` (string, optional, nullable) — Link to documentation for this error, when one exists; otherwise null. - `recovery` (string, optional, nullable) — Plain-language guidance on how to recover from this error, suitable for showing to the person who triggered it. Not present on every error. - `details` (any, optional) — Optional structured payload (e.g. a list of ValidationDetail for validation failures). Omitted from the wire when null so the canonical Stripe shape stays minimal. ## Examples **Request** ```json { "activity_type": "LoggedEmail", "activity_date": "string", "subject": "string" } ``` **Response** ```json { "object": "string", "id": "string", "activity_type": "string", "subject": "string", "description": "string", "date": 1, "amount": 1.1, "fund_id": "string", "campaign_id": "string", "assigned_to_user_id": "string", "is_completed": true } ``` **SDK Code** ```python import requests url = "https://api.awardspring.com/api/v1/donors/donorId/activities" payload = { "activity_type": "LoggedEmail", "activity_date": "string", "subject": "string" } headers = { "X-Spring-API-Key": "", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.awardspring.com/api/v1/donors/donorId/activities'; const options = { method: 'POST', headers: {'X-Spring-API-Key': '', 'Content-Type': 'application/json'}, body: '{"activity_type":"LoggedEmail","activity_date":"string","subject":"string"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.awardspring.com/api/v1/donors/donorId/activities" payload := strings.NewReader("{\n \"activity_type\": \"LoggedEmail\",\n \"activity_date\": \"string\",\n \"subject\": \"string\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("X-Spring-API-Key", "") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.awardspring.com/api/v1/donors/donorId/activities") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["X-Spring-API-Key"] = '' request["Content-Type"] = 'application/json' request.body = "{\n \"activity_type\": \"LoggedEmail\",\n \"activity_date\": \"string\",\n \"subject\": \"string\"\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.awardspring.com/api/v1/donors/donorId/activities") .header("X-Spring-API-Key", "") .header("Content-Type", "application/json") .body("{\n \"activity_type\": \"LoggedEmail\",\n \"activity_date\": \"string\",\n \"subject\": \"string\"\n}") .asString(); ``` ```php request('POST', 'https://api.awardspring.com/api/v1/donors/donorId/activities', [ 'body' => '{ "activity_type": "LoggedEmail", "activity_date": "string", "subject": "string" }', 'headers' => [ 'Content-Type' => 'application/json', 'X-Spring-API-Key' => '', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.awardspring.com/api/v1/donors/donorId/activities"); var request = new RestRequest(Method.POST); request.AddHeader("X-Spring-API-Key", ""); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"activity_type\": \"LoggedEmail\",\n \"activity_date\": \"string\",\n \"subject\": \"string\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "X-Spring-API-Key": "", "Content-Type": "application/json" ] let parameters = [ "activity_type": "LoggedEmail", "activity_date": "string", "subject": "string" ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.awardspring.com/api/v1/donors/donorId/activities")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```