HTTP

Global functions available to smart-app code. Call them by bare name; there is no object to import.

httpRequestCopy Anchor Link

Fire-and-forget outbound HTTP request from the hub. Useful for hitting integrations the action catalog doesn't cover (chat platforms, IFTTT, custom backends). The host issues the request off-thread; smart-app callers don't see the response. Errors are logged on the host side. headers is an object of string values; body is sent verbatim (set Content-Type in headers to declare the encoding).

SignatureCopy Anchor Link

function httpRequest(opts: { url: string; method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'; headers?: Record<string, string>; body?: string; }): { ok: boolean; reason?: string }

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

{ ok: boolean; reason?: string } — Whether the request was accepted for sending. The response is never visible to the app; failures are logged on the hub.

NotesCopy Anchor Link

• Redirects are not followed.
• Not available to AI-generated user automations.

ExamplesCopy Anchor Link

httpRequest({
  url: 'https://hooks.example.com/novon',
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ event: 'door-open', at: new Date().toISOString() }),
});

See alsoCopy Anchor Link

egress policy · http and egress