{"uid":"cap_HRpFVnHHqehr8SgZfmFnJ","slug":"oneshot-agent-api-crm-note-writer-e258a8a4","name":"OneShot Agent API – CRM Note Writer","description":"Tools, payments, and compute orchestration for autonomous AI agents.\n\n## Authentication\n\n- **`x402Payment`** — paid tool endpoints use the [x402 payment protocol](https://x402.io).\n  First call returns `402 Payment Required` with a quote; sign and resend the request\n  with `payment-signature: <base64 x402 payment>` and `X-Quote-ID: <quote_id>`.\n- **`agentId`** — free read-only endpoints accept `X-Agent-ID: <wallet>` (0x… address).\n- **`soulKey`** — soul marketplace seller dashboard uses `Authorization: Bearer soul_…`\n  (issued by `POST /v1/soul/register`).\n- **`acpBearer`** — Stripe ACP checkout sessions use a separate bearer token plus the\n  `API-Version: 2026-01-30` header.\n\n## Async tools & polling\n\nMost tool endpoints return `202 Accepted` with `{ request_id, tool, status }`. Poll\n`GET /v1/requests/{id}` (with the same `X-Agent-ID`) to retrieve the final result.\nA WebSocket fallback is available at `wss://<host>/v1/requests/subscribe`.\n\n## Pricing\n\nPrices are listed at [docs.oneshotagent.com/pricing](https://docs.oneshotagent.com/pricing).\nA wallet (x402) call returns its exact price in the 402 quote before anything is charged.\nCalls paid from prepaid credits (access-token sessions, and the phone number purchase at\n`POST /v1/tools/voice/numbers`) debit the credit balance when the request is accepted, before the work runs\n(`200` for a synchronous lookup, `201` for the number purchase, `202` for a queued job),\nand answer `402 insufficient_credits` with nothing charged or bought when the balance cannot cover it.\n\n## Error format\n\n`{ \"error\": \"<machine_code>\", \"message\": \"<human readable>\", \"details\": <optional> }`.\nValidation errors include a `details` field with the failing field paths.","url":"https://win.oneshotagent.com/v1/tools/crm/notes?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"body":{"type":"string","maxLength":5000,"minLength":1,"description":"Plain text note, at most 5,000 characters."},"record":{"type":"object","required":["type","id"],"properties":{"id":{"type":"string"},"type":{"enum":["account","contact","opportunity"],"type":"string"}},"additionalProperties":false},"connection_id":{"type":"string","format":"uuid","description":"List connections and select the system and account label to write to."}}},"responseSchema":{"type":"json","example":{"id":"501","source":{"id":"501","system":"hubspot"},"created_at":"2026-10-17T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0x0S9fKPpCQ1JpU2IbbWU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Writes a plain-text note to a CRM record (account, contact, or opportunity) in a connected CRM system such as HubSpot via the x402 paid tool protocol.","exampleAgentPrompt":"Log a note on the HubSpot contact with ID 'c-4892' via CRM connection '3fa85f64-5717-4562-b3fc-2c963f66afa6' that says: 'Called to discuss renewal — customer is interested, follow up next Monday.'","exampleUseCases":[{"title":"Log post-call summary to contact","prompt":"Add a note to contact ID 'ct-1023' in my CRM (connection '3fa85f64-5717-4562-b3fc-2c963f66afa6') that says: 'Spoke with Sarah about the Q3 renewal. She wants a revised quote by Friday.'"},{"title":"Append meeting notes to an opportunity","prompt":"Write a CRM note to opportunity ID 'opp-7741' on connection '9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d' summarizing today's demo: 'Ran a 45-minute product demo. Decision-makers present. Budget confirmed at $50k. Next step is legal review.'"},{"title":"Record onboarding activity on account","prompt":"Log a note on account 'acc-0055' in my connected CRM (connection 'f47ac10b-58cc-4372-a567-0e02b2c3d479'): 'Completed onboarding call. Credentials shared. Customer is live on the platform as of today.'"}],"resultDescription":"Returns a JSON object containing the new note's ID, the source system identifier and CRM system name (e.g. 'hubspot'), and the ISO 8601 timestamp when the note was created.","failureModes":["Invalid or missing connection_id returns a 4xx error indicating the CRM connection is not found or unauthorized","Record type not in allowed enum ('account','contact','opportunity') causes a validation error","Note body exceeding 5,000 characters or empty string fails schema validation","Payment not provided triggers 402 Payment Required with a quote; must resend with payment-signature and X-Quote-ID","Unknown record ID may result in a CRM-side error forwarded as a 4xx or 5xx","Expired or invalid x402 payment signature returns an authentication/payment error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to programmatically write free-text notes directly to a CRM record (account, contact, or opportunity) in a connected CRM like HubSpot, especially within an autonomous workflow where call summaries, meeting notes, or activity logs should be persisted to the CRM automatically. Prefer this over manual CRM entry or generic REST clients when the x402 micropayment model fits and CRM connectivity is managed through OneShot Agent's connection layer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:36:54.385Z","isFirstParty":false,"canonicalSlug":"oneshot-agent-api-crm-note-writer-e258a8a4"}