Ayudala icon

Ayudala

Interact with the Ayudala helpdesk & service management platform

Actions82

Purchase Request → Create

AI-generated

Summary

Create a new purchase request in Ayudala

Inputs

  • title (required) — Title of the purchase request
  • description (required) — Description of the purchase request
  • company_id — Company ID (required for staff callers when the API key is not company-scoped)
  • category — Procurement category
  • currency — ISO currency code (default USD)
  • justification — Business justification
  • linked_ticket_id — Optional ticket to link
  • linked_objective_id — Optional contract objective to link
  • estimated_budget — Estimated total budget override
  • itemsJson — JSON array of line items (category, description, quantity, unit, estimated_unit_price, notes)

Output shape

a single created purchase request object

Returns the created purchase request with its generated ID and timestamps; optional fields are included if provided; errors follow the standard error envelope.

Examples

Example 1: Create a purchase request for office chairs

title: 'Office Chairs'; description: 'Replace worn chairs'; currency: 'USD'; itemsJson: '[{"category":"Furniture","description":"Ergonomic Chair","quantity":10,"unit_price":150}]'

Example 2: Create a purchase request linked to ticket 12345

title: 'Conference Room Setup'; linked_ticket_id: 12345; justification: 'Setup for upcoming conference'; itemsJson: '[{"category":"IT","description":"Projector","quantity":1,"unit_price":800}]'

Example 3: Create a purchase request linked to an objective

title: 'Software License Renewal'; linked_objective_id: 789; category: 'Software'; itemsJson: '[{"category":"Software","description":"License Renewal","quantity":5,"unit_price":200}]'

Links

Discussion