Currents API

5 tools available

Currents News API provides access to the latest news articles from various sources worldwide, supporting multiple languages and categories.

Connect Currents API to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Currents API's 5 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.

Common workflows with Currents API

01

Trigger on event

  1. Listen for a new event
  2. Parse and validate the payload
  3. Take an action with the linked tool
02

Daily summary

  1. Pull yesterday's activity
  2. Summarise with the model of your choice
  3. Send the digest via email or Slack
03

Cross-tool sync

  1. Read records from one app
  2. Transform with a persona
  3. Write the result back via this integration

Currents API actions 5

Every Currents API action below is a callable tool any Definable persona can invoke.

List Latest News

Tool to retrieve the latest news articles from Currents News API. Use when you need a real-time feed of recent articles.

Activities Watch

Start a push notification channel to watch user activities for Google Workspace applications. This action sets up a webhook to receive real-time notifications when activities occur in Google Workspace apps (admin, calendar, drive, docs, gmail, meet, etc.). Prerequisites: - Valid webhook URL that can receive POST notifications - OAuth credentials with appropriate scopes for the target application - For production use, requires Google Admin Reports API access Use this when you need to monitor user activities in real-time rather than polling.

Get Entity Usage Reports

Tool to retrieve usage statistics for a specific Google Workspace entity. Use when you need to analyze entity usage on a particular date.

List Users

Tool to list users in a Google Workspace domain. Note: - When the provided base_url points to Currents News API (api.currentsapi.services), this action will gracefully fall back to listing latest news articles to ensure a valid response, since the Currents News API does not expose a users endpoint. - When the base_url points to Google Admin Directory API, it will list users from the domain/customer specified.

Search News Articles

Retrieve news articles from Currents News API with flexible search and filtering. Use this tool to: - Search for news articles by keywords or phrases - Filter articles by language, category, country, or date range - Retrieve paginated results for large result sets - Access comprehensive news data including titles, descriptions, authors, and publication dates This tool provides access to real-time global news content for information gathering, research, monitoring, or content curation purposes.

Frequently asked questions

What can I automate with Currents API on Definable?

Anything Currents API exposes through its API. Common news & lifestyle workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 5 Currents API tools directly, then chain the result into another integration without you writing code.

How does Currents API authentication work?

Currents API uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Currents API integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 5 Currents API tools. You only need a separate Currents API subscription if Currents API itself charges per seat or per API call.

Is using Currents API through Definable secure?

Every call from a persona to Currents API is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Currents API on Definable?

Sign up for Definable, open the integrations page, find Currents API, and connect via OAuth or API key. You can immediately attach Currents API to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Currents API actions does Definable expose?

Definable exposes all 5 Currents API actions as callable tools — including `List Latest News`, `Activities Watch`, `Get Entity Usage Reports`, plus 2 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Currents API?

Wire it up in minutes. No coding required.

← All integrations