wishbest BUSINESS简体中文
API preview · activation required

THOUGHTFUL CONNECTIONS, BUILT INTO YOUR WORK

The moment matters.
Make the follow-up personal.

A closing, a completed project, a customer milestone. Connect your business system to Wishbest and send a branded greeting by email or text.

This is a testable API preview. The hosted API is not activated yet. Real email and SMS delivery requires account provisioning and sender setup; test keys never send messages.

Explore the integration
01 / BRAND

Your identity, remembered

Save your logo, business name and signature. Adjust the logo size and left, center or right alignment.

02 / SEND

Email or text

Email shows the card image with your message. SMS carries a short note and a link to the online card.

03 / FOLLOW THROUGH

One event. One delivery.

A stable request key prevents duplicate jobs. Check whether a request is queued, simulated or accepted by the provider.

A natural next step after closing.

Closing recorded → Your CRM calls Wishbest → Branded card → Email or SMS

Your CRM or automation tool supplies the trigger and any anniversary schedule. This preview accepts an already exported card image; automatic image rendering and ready-made CRM connectors are not included yet.

DEVELOPER GUIDE

Connect once. Send with care.

Call from your server with a business API key. Keep keys out of browser and mobile app code. Start locally at http://localhost:8787.

1. Submit a card
POST /v1/deliveries
Authorization: Bearer YOUR_TEST_KEY
Content-Type: application/json
Idempotency-Key: closing-customer-42-email

{
  "channel": "email",
  "to": "client@example.com",
  "recipient_name": "Sarah & James",
  "heading": "A new home. A new chapter.",
  "message": "Thank you for trusting me with your next chapter.",
  "image_url": "https://wishbest.app/assets/app-business-landscape.webp",
  "consent": {
    "confirmed": true,
    "source": "CRM customer preferences",
    "obtained_at": "2026-11-12T10:00:00Z"
  }
}

Replace the example image with your exported card on an approved HTTPS asset host. Consent must reflect the recipient’s actual channel preference. Use a different event key for each occasion and channel; repeat the same key when retrying.

For SMS, set channel to sms and to to an E.164 number such as +14155550123. SMS uses a card link; MMS image attachments are not included.

2. Save your brand
PUT /v1/brand
Authorization: Bearer YOUR_TEST_KEY
Content-Type: application/json

{
  "name": "Emma Realty",
  "signature": "Warmly, Emma Chen",
  "logo_url": "https://your-approved-asset-host.example/logo.png",
  "logo_width": 120,
  "logo_align": "left"
}

Logo width: 40–220 pixels. Alignment: left, center or right. The asset host must first be approved for your business. These settings are stored for the API and do not yet sync with the web or mobile editor.

3. Check or cancel a request
GET /v1/account
GET /v1/deliveries/{id}
DELETE /v1/deliveries/{id}

GET account shows your channel readiness and daily limit. You can cancel before a delivery starts. A repeated Idempotency-Key returns the original request; different content with the same key returns 409.

Clear states, honest expectations.

queuedSaved and waiting to be processed.
simulatedTest preview created. No message sent.
submittedAccepted by the sending provider. This is not a delivery receipt.
failedNot accepted or blocked by configuration or recipient preferences.
delivery_unknownThe result is uncertain. Check with the provider before sending again.

Online cards expire after 90 days. Anyone with the private card link can view it. Email includes an unsubscribe option; SMS requires an activated sender with STOP handling. No bulk campaigns, billing or final delivery receipts are included in this preview.

Start with your next meaningful moment.

Explore business designs