SA.Automate.WeatherApi 1.0.7

SA.Automate.WeatherApi

WeatherAPI.com connection types and actions for Umbraco Automate. Get the current weather or today's forecast for a location as part of an automation workflow.

What is WeatherAPI.com?

WeatherAPI.com is a JSON/XML weather API that provides current weather, forecasts, and historical weather for locations worldwide, looked up by city name, postcode/zip, IP address, or latitude/longitude.

What can this be used for?

This package is useful when you want current weather data inside an Umbraco Automate workflow, for example:

• Conditional content: branch a workflow based on the current conditions at a location.
• Enriching notifications: include the current temperature or conditions in a message sent by another action.
• Logging/reporting: record weather conditions alongside other workflow data.

Installation

dotnet add package SA.Automate.WeatherApi

No further setup required. The composer registers itself automatically via Umbraco's IComposer discovery.

Connection types

This package registers a single WeatherAPI.com connection type:

• API Key: required. The WeatherAPI.com API key used by this connection.

Setup

1. Get an API key

Get a free API key from weatherapi.com.

2. Store the key in appsettings.json (optional)

The connection's API Key field is marked sensitive, so instead of entering the key directly in the backoffice you can store it in appsettings.json and reference it using Umbraco Automate's configuration reference syntax:

{
  "Umbraco": {
    "Automate": {
      "Secrets": {
        "WeatherApiKey": "your-api-key"
      }
    }
  }
}

3. Create the connection in the backoffice

1. Go to Automate → Connections and create a new WeatherAPI.com connection.

2. Give the connection a name and enter your API Key — either the key itself, or, if you stored it in appsettings.json above, this reference:

   $Umbraco:Automate:Secrets:WeatherApiKey
   

3. Click Test connection to verify. This requests the current weather for a known location to confirm the API key is valid.

Usage

Get Current Weather

Add the Get Current Weather action to any automation and select the connection to use. Available fields:

The action outputs the following, which can be referenced via bindings in later workflow steps:

Get Today's Weather

Add the Get Today's Weather action to any automation and select the connection to use. Available fields:

The action outputs the following, which can be referenced via bindings in later workflow steps:

Compatibility

Links

• Source code
• Report an issue
• WeatherAPI.com documentation