- 4 minutes to read

Add or manage Integration

Gain full control over your integration landscape with Nodinite. This guide shows you how to add, document, and manage integrations, connect services, use custom fields, and monitor relationships—empowering your team to keep integrations in sync with your business and technical needs.

✅ Add and document integrations for a complete repository
✅ Connect services and manage relationships visually
✅ Use custom fields for flexible, business-relevant metadata
✅ Monitor integration health and links to Monitor Views
✅ Empower your team with intuitive, self-service management

This guide teaches how to add or manage an Integration.

Tutorial overview

Use the following table as your to-do list for managing Integrations. Stay organized and ensure every integration is fully documented and connected for maximum business value.

# Topic
1. Add or Manage Integration
2. Name the Integration
3. Manage Custom Fields
4. Manage Services
5. Monitor View relations
6. Enrich with Custom Metadata
7. Link Articles

Step 1: Add or Manage Integration

Click the Add/New button to create a new Integration or the Duplicate button to clone the current one.
Copy API URL and Add Integration buttons in the Integrations page header (7.12)
Click Add Integration to add a new Integration.

The Add Integration page opens. Everything about the Integration is on one page: the fields on the left, and a card per relation on the right, each with its own Edit button.
Add Integration page with Name, Description, Web Site, C4 Properties, and Custom Metadata on the left, and the Log Views, Monitor Views, Services, Contracts, Custom Fields, and Articles cards on the right (7.12)
The Add Integration page; the Relations tab lists the related Monitor Views (Step 5).

Card What you manage there
Log Views The Log Views related to the Integration
Monitor Views The Monitor Views related to the Integration (Step 5)
Services The Services that make up the Integration (Step 4)
Contracts The Contracts used by the Integration
Custom Fields Custom Fields values (Step 3)
Articles The Articles that document the Integration (Step 7)

Step 2: Name the Integration

Give your Integration a unique, descriptive name. You can update this name at any time to reflect changes in your business or technical landscape.
General tab with Name (required), Description, and Web Site, next to the Relations tab (7.12)
Only Name is mandatory; the Relations tab lists the related Monitor Views (Step 5).

Mandatory fields

  • Name: Every Integration must have a unique, user-friendly name. You can safely change this name at any time.

Optional fields

  • Description – Provide a clear, user-friendly description of the integration's purpose.
  • Web Site – Add a quick link for users, such as a WIKI or SharePoint page, for additional documentation.
  • Tags – New 7.12 Add Tags to label the Integration. Find it later with Filter on Tag in the list, and tag many at once with With Selected > Manage Tags.
  • C4 Properties – Expand to set how the Integration is drawn in C4 Diagrams; see Repository Properties for C4 Diagramming.

For ongoing management, use the Integration Landscape feature for a visual, intuitive experience.

Step 3: Manage Custom Fields

As part of the Repository Model, you can manage Custom Fields to add flexible, unstructured documentation to your Integration.

Custom Fields card with the SLA Level field set to Gold, a comment, and a remove button (7.12)
Each Custom Field shows its value, comment, and link; the card header counts them.

Click the Edit button to manage Custom Fields. You can Add, Remove, and update values for the available Custom Fields.
Manage CustomFields
Example modal showing how to manage Custom Fields for an Integration.

We recommend using Custom Metadata for even greater flexibility and structure.

Step 4: Manage Services

Connect one or more Services to an Integration. For a graphical approach, use the Integration Landscape feature.
Services card with 14 Services, each with its direction icon, an edit button, its description, its System, and a remove button (7.12)
Click Edit on the card to add Services, or the remove icon on a row to take that Service off the Integration.

You can Add, Remove, and Filter the list of available Services.
Connect Services to Integration
Examples of Services to add for the current Integration.

Step 5: Monitor View relations

See which Monitor Views are linked to your Integration as part of the monitoring feature. This information is available in the Relations tab.
Relations tab
Here's an example of the Relations tab.

The list and state of associated Monitor Views are presented here. You can filter the list, and clicking any Monitor View takes you to the Add or manage Monitor View.

Related Monitor Views For Integration
Example list of currently associated Monitor Views for an Integration.

Step 6: Enrich with Custom Metadata

Add Custom Metadata, such as an owner or an SLA level, in the Custom Metadata section at the bottom of the page. Click Add Custom Metadata to add a field, and switch to Preview to see how it reads. See Add or manage Custom Metadata for the field types, and Portfolio Filtering for how to find Integrations by these values later.

New 7.12

The Articles card lists the Articles that document the Integration, such as a design document or a runbook. Click Edit on the card to choose them. A new Integration shows No Articles document this Integration yet. See The Articles Card on Repository Entities.

Next Steps

Add or manage Custom Field
Add or manage Service
Add or manage Article
Manage Integrations - delete and restore Integrations

Systems
Custom Metadata
Articles
Repository Model
Services
Custom Fields