WorkAPI.ai

Send Flower To Anyone Service

We can send flower to your dedicated address and contact person with one API call

About This Service

Flower Delivery as an API.

Send real flowers to anyone with a single API call.
Automate gifting, rewards, apologies, surprises, or emotional moments directly from your product.

Use cases:

AI assistants sending gifts
Marketplace seller rewards
Loyalty programs
Customer retention campaigns
Surprise & delight automation
Event-triggered gifting (birthday, milestone, etc.)

Fast integration. Global coverage. Real-world impact.

Quick Start

1. Get your API key

Ask WorkAPI.ai for an API key. You'll get a key like sk_live_xxxxx.

2. Create your first task

curl -X POST https://api.workapi.ai/api/v1/workapi-ai/send-flower-to-anyone-service/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "full_address": "Example full_address",
  "recipent_name": "Example recipent_name",
  "contact_phone_number": "Example contact_phone_number"
}'

3. Check the task status

curl https://api.workapi.ai/api/v1/workapi-ai/send-flower-to-anyone-service/tasks/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Authentication

All requests require an API key passed in the Authorization header:

Authorization: Bearer sk_live_your_api_key_here

Endpoints

Base URL:https://api.workapi.ai/api/v1/workapi-ai/send-flower-to-anyone-service

Input Data

Field	Type	Required	Description
full_address	string	Yes	Full Address, including country and city
recipent_name	string	Yes	recipent_name
contact_phone_number	string	Yes	Contact Person Phone Number, including country code E.164 format.

Output Data

When a task is completed, the following data will be included in the result. These fields are returned in the result_data object.

Field	Type	Required	Description
latest_delivery_status	enum (in_production, en_route, delivered)	No	latest delivery status

Task Lifecycle

pending

→

accepted

→

in_progress

→

completed

pending — Task created, waiting to be accepted by staff.

accepted — Staff member has accepted the task. Caller can still cancel.

in_progress — Work has begun. Cannot be cancelled.

completed — Task is done.

cancelled — Task was cancelled before work started.

Webhooks

Configure a webhook URL on your API key to receive notifications when task status changes. Webhooks are signed with HMAC-SHA256 using your webhook secret. A single task.updated event is sent whenever a task is created, its status changes, or its data is updated. The full task details are included in every webhook payload.

Event	Description
task.updated	Fired when a task is created, status changes, or task data is updated. Returns full task details.

Example webhook payload:

{
  "event": "task.updated",
  "timestamp": "2026-02-20T12:00:00.000Z",
  "task_id": "65abc123def456...",
  "task_number": 42,
  "status": "completed",
  "task_data": {
    "...": "your input data"
  },
  "result_data": {
    "...": "output data or null"
  },
  "merchant_id": "65abc..."
}

Error Codes

Status	Code	Description
400	VALIDATION_ERROR	Missing or invalid fields in request body
401	UNAUTHORIZED	Missing or invalid API key
403	FORBIDDEN	API key does not have access to this service
404	NOT_FOUND	Resource not found
409	INVALID_STATUS	Action not allowed for current task status
429	RATE_LIMITED	Too many requests. Check Retry-After header