Outbound Wiki

Integration partnership models

The different ways two products can work together, including native integrations, connectors, embedded features and shared APIs.

An integration partnership starts with the customer task that becomes easier when products work together. Choose a model based on the data path, the ownership boundary, and the operating burden each team can carry. The partnership connects products through an app between their systems so customers can use them together with less friction.1 It lets customers access, share, and move data without taxing their developers or bringing in another party.2

The partner's technical boundary can settle the design before the teams discuss architecture. An external partner may require EDI, a fixed file format, or a specific API contract.3 Establish that boundary first because it can override the other choices.4

The models

Use the model that matches the customer job and the way the connection must be owned. The customer experience may look similar across partnerships, while the build and operating obligations differ.

Native integration

Choose native when the connection should feel like part of the product experience and remain a maintained product capability. Technology integration partners create ecosystem value by building native integrations between a platform and complementary tools.5

Ask where setup happens, which product owns authentication, who handles failures, and what the customer can configure. Continue when both teams can describe the customer path and ownership boundary in the same terms.

Connector or iPaaS

Use a connector or iPaaS when breadth matters and the connection follows patterns already covered by the platform. Mature integration landscapes often use iPaaS for the long tail of SaaS-to-SaaS connections and hand-built integrations for core, high-volume, differentiated flows.6

Check for coverage gaps, limits on data movement, and the work required to monitor changes. A series of integration steps can become messy as third-party needs accumulate.7 Ask which parts the connector owns and which still need custom work.

Custom integration

Use a hand-built integration when the connection needs direct control over behavior, performance, or change handling. This approach fits flows that are few but deep and specific, performance-critical, highly regulated, unsupported by available connectors, or too costly to run on a platform.8

For shared customers, the teams can collaborate on custom integrations that extend product functionality and the user experience.9 Ask who will build the connection, who will operate it after release, and how either partner can change the contract without breaking the customer workflow.

Shared API

Use a shared API model when both products need a durable contract for access, updates, or data exchange. Client libraries can provide programmatic access to products through their APIs.10 A Partner Procurement API can create linked customer accounts and send and receive updates about user accounts.11

Set the direction explicitly. External applications are often integrated so data flows bidirectionally between systems.12 Where the partnership needs cross-product consistency, shared authorization, APIs, and data models can make that integration possible.13 Ask which system owns each record, which events trigger updates, and what happens when both sides change the same data.

Layered or embedded capability

Use a layered model when one product needs to add a higher-level capability on top of another system. A higher-level API or orchestration layer can sit above an underlying database.14

For an embedded feature, identify where the host product ends and the partner capability begins. Confirm which product owns the user experience, permissions, data access, and support path. Continue when the customer can understand where the capability lives and the teams can explain how it receives the context it needs.

Run the choice in order

  1. Partner boundary
  2. Data path
  3. Build path
  4. Business horizon
  5. Success measure

Treat the selection as a sequence of gates. Record the answer at each gate before choosing a model.

Partner boundary

Start with the formats, endpoints, and change rules the partner will permit. Ask what the system accepts today, who controls the contract, and what notice comes with a change. If the constraint is fixed, let it shape the shortlist.

Data path

Map how fresh the data must be, how much moves and how often, who initiates the flow, which direction it travels, and what the team can operate.15 Ask what stale, duplicated, delayed, or rejected data would cause. Continue when the customer job and the data behavior are described together.

Build path

Compare connector coverage, team capacity, and the expected number of integrations before choosing between iPaaS and hand-built work.16 Ask what the team can monitor during an ordinary week and during an incident. A model that saves build time while creating an operating burden has failed this gate.

Business horizon

Balance the immediate business requirement with the flexibility the partnership will need later.17 Ask whether the contract, ownership, and support model can survive a change in the customer workflow. Record the answer before discussing implementation detail.

Success measure

Decide how to assess effectiveness before work starts. Measures need to be available even though some significant effects can be difficult to measure.18 Ask what improvement the customer should notice, what operational signal shows the connection is healthy, and when the partnership should be reviewed.

What to measure

Measure the customer task the partnership was created to improve, along with the operating work required to keep the connection useful. Keep the measures close to the workflow so the teams can act on them.

An integration should become routine, seamless, efficient, and effective in supporting the customer's goals.19 Track whether setup completes, data reaches the intended destination, failures are recoverable, and the customer can finish the intended task without extra manual work. Review the measures with the people who own the connection and adjust them when the customer workflow changes.

What not to do

The common failures come from treating the mechanism as the partnership. Technology is a tool for improving productivity and practice.20 Keep immediate build convenience from outweighing the current requirement and long-term flexibility.17 Keep measures available even when some effects are difficult to measure.18 A working test path does not by itself show routine, seamless, efficient, and effective support for the customer's goals.19

Before build work starts, take the boundary and data-path questions into the partner call and record who owns setup, changes, failures, and customer communication.

Sources

  1. 1
    “An integration partnership is when two SaaS companies connect their products by building an app between their systems so that customers can have a smoother, more functional experience while using the two technologies.”
  2. 2
    “Customers can more easily access,share, and move data between different products without having to tax their developers or engage in a new relationship with an agency or other third party.”
  3. 3
    “Integrating with an external partner, a bank, a supplier, a government portal, a logistics provider, means you take whatever they support, and that is frequently EDI, a fixed file format, or a specific API contract you cannot change.”
  4. 4
    “The partner constraint often overrides every other consideration, so establish it early before you design anything.”
  5. 5
    “Technology integration partners create ecosystem value by building native integrations between your platform and complementary tools.”
  6. 6
    “Many mature landscapes end up with both: an iPaaS handling the long tail of SaaS-to-SaaS connections, and hand-built integrations for the few core, high-volume, differentiated flows.”
  7. 7
    “Now, you can technically handle both Salesforce and Amazon SNS integrations through a series of integration steps, but it gets messy.”
  8. 8
    “Lean toward building it yourself when the integration is few in number but deep and specific, when it sits in a performance-critical or highly regulated path, when your systems are bespoke enough that no connector exists, or when platform subscription and per-transaction costs would outweigh the engineering saved.”
  9. 9
    “Collaborate on custom integrations: Have your engineering teams collaborate on developing custom integrations for shared customers, enhancing the product’s functionality and user experience.”
  10. 10
    “You can integrate your app with Google APIs by using client libraries, which give you programmatic access to Google products.”
  11. 11
    “To create linked accounts for customers, and to send and receive updates about user accounts, you must also integrate with the Partner Procurement API.”
  12. 12
    “In order to make the best out of CRM data, there is often a need to integrate external applications with Salesforce such that data can flow bidirectionally between them.”
  13. 13
    “This cross-product integration is only possible because all Google services use the same authorization system with consistent APIs and data models.”
  14. 14
    “Oracle AI Agent Memory and LangChain can then sit above that layer when developers need higher-level APIs or orchestration.”
  15. 15
    “Ask how fresh the data must be, how much of it moves and how often, who initiates and in which direction, whether the other side is a partner you must conform to, and what your team can actually operate.”
  16. 16
    “The decision hinges on connector coverage, team capacity and the number of integrations you expect to run.”
  17. 17
    “An architect’s decision should balance immediate business requirements with long-term flexibility.”
  18. 18
    “Measures need to be available to assess effectiveness, and yet some of the most significant effects can be difficult to measure.”
  19. 19
    “it is important that integration be routine, seamless, and both efficient and effective in supporting school goals and purposes.”
  20. 20
    “technology is a tool to improve productivity and practice.”