# Create an external service

Copy as Markdown[View as Markdown](/docs/development/guides/resources/services/create-external-service.md)

***

**Added in** `eventcatalog@3.28.0`

External services are services your architecture integrates with but does not own — Stripe, Twilio, Snowflake, Auth0, and similar third-party providers. They behave like any other service in EventCatalog: they can send and receive messages, be versioned, have owners, and carry specifications. The only difference is how they are presented — purple with a Globe icon and an "External System" badge in the visualiser, and grouped under a dedicated "External Services" section in the sidebar (or "External Integrations" when inside a domain).

Creating an external service is identical to creating a regular service — just add `externalSystem: true` to the frontmatter.

## Example: modelling Stripe[​](#example-modelling-stripe "Direct link to Example: modelling Stripe")

Here is an example modelling Stripe as an external service. Stripe receives a `ChargeCard` command from your `PaymentGatewayService` and sends back `StripeChargeSucceeded` and `StripeChargeFailed` webhook events.

/services/Stripe/index.mdx (example)

```
---
id: Stripe
name: Stripe
version: 1.0.0
summary: External payment processor used to charge customer cards.
externalSystem: true
receives:
  - id: ChargeCard
    version: 0.0.1
sends:
  - id: StripeChargeSucceeded
    version: 0.0.1
  - id: StripeChargeFailed
    version: 0.0.1
---

## Overview

Stripe is used to process card payments. We send a `ChargeCard` command and Stripe
webhooks back `StripeChargeSucceeded` or `StripeChargeFailed` to complete the round trip.

<NodeGraph />
```

Your paired `PaymentGatewayService` would mirror this — `sends: [ChargeCard]` and `receives: [StripeChargeSucceeded, StripeChargeFailed]` — giving you a complete integration contract visible in the visualiser.

![Stripe rendered as an external service in the EventCatalog visualiser](/assets/images/external-system-stripe-5af07084e45d1e75f26f3eec36b2e0e2.png)

Modelling third-party systems this way lets you document exactly what you call and what they call back, see external dependencies cleanly separated from your own services on the visualiser, and reason about which of your services depend on which third parties.