Create a Wish

Create a Wish

The simplest way to interact with the soft.house API is to create a wish. A wish represents a user’s intent to purchase something, and the API handles finding the best options.

Using cURL

curl -X POST https://api.soft.house/wishes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Find me a laptop",
    "budget": {
      "max": 1500,
      "currency": "USD"
    },
    "preferences": {
      "brand": ["Apple", "Dell", "Lenovo"],
      "priority": "performance"
    }
  }'

Using TypeScript

const response = await fetch('https://api.soft.house/wishes', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.SOFT_HOUSE_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Find me a laptop',
    budget: {
      max: 1500,
      currency: 'USD',
    },
    preferences: {
      brand: ['Apple', 'Dell', 'Lenovo'],
      priority: 'performance',
    },
  }),
});

const wish = await response.json();
console.log(`Wish created: ${wish.id}`);

Using Python

import requests

response = requests.post(
    'https://api.soft.house/wishes',
    headers={
        'Authorization': f'Bearer {api_key}',
        'Content-Type': 'application/json',
    },
    json={
        'title': 'Find me a laptop',
        'budget': {'max': 1500, 'currency': 'USD'},
        'preferences': {
            'brand': ['Apple', 'Dell', 'Lenovo'],
            'priority': 'performance',
        },
    },
)

wish = response.json()
print(f"Wish created: {wish['id']}")

Response

{
  "id": "wish_abc123",
  "title": "Find me a laptop",
  "status": "active",
  "budget": {
    "max": 1500,
    "currency": "USD"
  },
  "created_at": "2026-03-03T12:00:00Z"
}

Next Steps

• List your wishes to check status
• Set up webhooks for real-time updates
• Try the AP2 mandate flow for autonomous purchasing