Skip to content
AstroWay/api v2.190.0 · integrations
all systems operational

Zapier

A Zap that takes a birth date, time, zone and coordinates from its trigger, asks the API for the chart and turns the Ascendant into a sign name. The request below was sent to production exactly as the step builds it; the Zapier steps follow Zapier’s own help center as of 2026-09-17.

Before you start, create a key as described in A key for an automation, scoped to chart.

Header values typed into a Webhooks by Zapier step are stored in the step, where anyone with access to the Zap can read them. API by Zapier keeps them in a connection instead.

  1. On the Apps page press + Add connection and pick API by Zapier.
  2. Authentication type: Static Headers (API key).
  3. Headers: X-Api-Key: followed by your key, on one line.
  4. Domain filter: api.astroway.info, so the connection cannot be pointed anywhere else.

Add an action, pick API by Zapier, event API Request, and choose the connection.

  • Method: POST.

  • URL:

    https://api.astroway.info/v1/chart
  • Body: the JSON below, with the trigger’s fields mapped in.

{
"date": "1990-05-15",
"time": "14:30:00",
"timezone": "Europe/Kyiv",
"latitude": "50.45",
"longitude": "30.52"
}

Replace each value with the matching field from your trigger and keep the quotes around every one of them, numbers included. Zapier inserts a mapped field as plain text and does not add quotes for you, and the API accepts "50.45" as a number. Do not add the key in the step’s Headers: the connection supplies it.

Test the step. A good answer starts with "ok": true, and data.input.timezoneOffset is 4 for the example: the offset Kyiv kept on that date.

Two Formatter steps.

Formatter, event Numbers, transform Spreadsheet-Style Formula. Formula:

FLOOR(ASCENDANT / 30)

with ASCENDANT replaced by the mapped data.houses.ascendant from step 2. For the example it gives 5.

Formatter, event Utilities, transform Lookup Table. Lookup Key is the result of the formula. The table:

KeyValue
0Aries
1Taurus
2Gemini
3Cancer
4Leo
5Virgo
6Libra
7Scorpio
8Sagittarius
9Capricorn
10Aquarius
11Pisces

The result for the example is Virgo.

The Sun and the Moon work the same way. They are the first and second entries of data.planets, each with its own longitude: 54.34 (Taurus) and 296.39 (Capricorn) for the example.

It works, with the key in the step rather than in a connection. For the chart choose the Custom Request event: it sends the Data field exactly as typed, so the JSON above goes out unchanged. Set Method to POST, and in Headers add both X-Api-Key with your key and Content-Type with application/json.

  • 400 INVALID_FIELD with timezone in details: the mapped zone is empty, an abbreviation such as EST, or not a zone name.
  • 400 with date or time in details: the trigger’s format is not YYYY-MM-DD / HH:MM:SS; add a Formatter date step before the call.
  • 403 ENDPOINT_NOT_IN_SCOPE: the key’s scope does not include chart.
  • 429 KEY_BUDGET_EXHAUSTED: the key reached its own budget; raise it in the dashboard.

The API does not geocode. If your trigger only has a place name, the coordinates need to come from the trigger itself or from a geocoding service you hold a key for.

Was this helpful?
Suggest an edit

Last updated: