- Using OGOship OpenAPI
- ApiV1
- Tracking Service
- Order Service
- Claims
- File a new claim based on orderId
- Get claims by orderId
- Get claim
- Update claim
- Create or update claim
- Get claims search definitions
- Get filtered claims
- Cancel claim.
- Refund claim to ecom.
- Get new claims dashboard data for a channel
- Set owner for a claim
- Remove owner from a claim
- Run action on claims
- Add a tag to a customer claim
- Remove a tag from a customer claim
- Emission
- Fabrikator
- Label
- Location
- Order
- Set order tracking status and tracking time
- Create exchange order
- Send exchange order (set to NEW status in myOGO1)
- Cancel order in myOGO1
- Stop (move to RESERVED status) order in myOGO1
- Search orders. Channel number specifies the location to search from.
- Get order by string orderId
- Create external order
- Update external order
- Get external order by orderId
- Get external orders by channelId
- ReturnDeliveryTypes
- Returns
- Change refund status of both return ordersPATCH
- Gets list of returnsGET
- Get filter definitions for front end searchGET
- Search for orders with defined filtersPOST
- Gets return dashboard dataGET
- Get return by idGET
- Gets return dashboard dataGET
- Get myOgo2 return by returnIdGET
- Update a myOGO2 returnPATCH
- Get myOgo2 returns by orderId (Full info for admins or merchants)GET
- Get myOgo2 returns by orderId (customer version)GET
- Request a new return. Checks merchant settings and creates a return to myOGO1 if the status of the return is WAITING.POST
- Get channels myOgo2 returnsPOST
- Run actions for returnsPOST
- Get filter definitions for front end searchGET
- Approve requested return order.GET
- Close requested return order.GET
- Change return order back to requested status.GET
- Cancel return order.GET
- Create return to ecom.GET
- Complete return at ecom.GET
- Create shipment to tracking service from return order.GET
- Merge returns.POST
- Update exchange order to be sent in ecom and/or myOGO.GET
- Create or update draft return orderPOST
- Initialize return from claimGET
- Initialize return from orderGET
- Finish draft returnGET
- Create exchange order (admin only)GET
- Send notification to customer about return orderGET
- Get open returns dashboard data for a channelGET
- Set owner for a returnPUT
- Remove owner from a returnDELETE
- Add a tag to a return orderPOST
- Remove a tag from a return orderDELETE
- Change refund status of both return orders
- Shipment
- Notification Service
- ChannelEvents
- Chat
- Get chat conversation by id
- Create or update chat conversation (Admin or system only)
- Update an existing chat conversation
- Delete chat conversation (Admin or system only)
- Get chat conversation by id with messages
- Get chat messages for a conversation
- Get all chat conversations for a channel
- Create a new chat conversation
- Add a single message to an existing chat conversation
- Set feedback on a chat message
- /chat/{channelId}/dashboard
- KlaviyoApi
- Configure Klaviyo integration for a channel with API keys
- Get Klaviyo account details for a channel
- Get lists from Klaviyo
- Get segments from Klaviyo
- Get email templates from Klaviyo
- Create or update a profile in Klaviyo
- Add a profile to a list
- Send a transactional email through Klaviyo
- Track a custom event in Klaviyo
- Update account metrics from Klaviyo
- Remove Klaviyo integration for a channel
- Messaging
- Notifications
- NotificationSettings
- NotificationTemplate
- Get frame for editor
- Update existing frame
- Remove existing frame
- Get frame for editor
- Update existing template
- Get all templates by channel id
- Get all frames by channel id
- Add new template
- Add new frame
- Preview frame
- Preview template
- Preview template to email/SMS
- Get sample model
- Copy all frames from another channel Overwrite: true will overwrite existing frames, false will only copy missing frames
- Copy all templates from another channel Overwrite: true will overwrite existing templates, false will only copy missing templates
- Delete all old frames and templates and copy new ones from source channel to target channel Overwrite input has no effect
- /notificationTemplates/ogoTemplates
- /notificationTemplates/ogoUsageKeys
- SlackApi
- Transactional
- Creates new message
- Gets message
- Updates existing message if exist
- Getting message by id
- Marking message as deleted
- Get all active messages using merchantId identifier. Marks all as read.
- Add transaction to message using merchantId identifier. (Draft = 0, Sent = 1, Read = 2, Skipped = 3, Agreed = 4, Rejected = 5)
- Get's all recipients of message (Draft = 0, Sent = 1, Read = 2, Skipped = 3, Agreed = 4, Rejected = 5)
- Adds recipient to message Returns list of recipients
- Updates all recipients for message
- Simplified add recipient Returns list of recipients for current merchant
- Simplified add recipient Returns list of recipients for current merchant
- Create transaction
- Create transaction
- Generates message token (DEV_ONLY) Crashes API
- WebHook
- ZendeskApi
- Generates a Zendesk OAuth authorization link for the user to authorize the application.
- Handles the OAuth callback from Zendesk after user authorization
- Get tickets from Zendesk for a channel
- Get Zendesk account details for a channel
- Get available groups from Zendesk
- Create a new ticket in Zendesk
- Add a comment to an existing ticket
- Update a ticket's status
- Removes the Zendesk integration for the specified channel
- Schemas
- Schemas
- AddCommentRequest
- AddToListRequest
- ChannelEventOption
- ChannelEventOptionTemplate
- ChannelEventSubscriptionTemplate
- ChannelEventSubscriptionsDto
- ChannelNotificationsSettingsDto
- ChannelNotificationsSettingsUpdateDto
- ProblemDetails
- ChatConversationDto
- ChatConversationUpdateDto
- ChatMessageDto
- ChatParticipantDto
- ConfigureKlaviyoRequest
- ConversationDashboardDto
- ConversationMetadataDto
- ConversationMetadataUpdateDto
- CopySettings
- CreateProfileRequest
- CreateTicketRequest
- CreateTransactionalMessageModel
- CustomWebhookMessage
- EChannelEventOptionType
- EContentType
- EMessageApproval
- EMessageReceiver
- EMessageRecipientStatus
- EMessageRecipientType
- EMessageSource
- EMessageType
- EventDeliveryTypeDto
- EventSubscriptionDto
- Feedback
- FileAttachmentDto
- FrameDetails
- KlaviyoAccountPublicDetails
- LocaleString
- MessageContentDto
- MessageContext
- MessageDto
- MessageFeedbackDto
- NotificationChannels
- NotificationFrameDto
- NotificationProviderSettingsDto
- NotificationTemplateDto
- ProviderResponse
- ProvidersListResponse
- RecipientTransactionsDto
- SendAttachmentDto
- SendDto
- SendEmailRequest
- SendRawDto
- SendTestDto
- SlackTeam
- SlackTeamPublicDetails
- StringStringKeyValuePair
- TemplateLocalizedString
- TrackEventRequest
- TransactionDto
- TransactionalMessageContentDto
- TransactionalMessageDto
- UiDataField
- UiDataFieldOption
- UpdateTicketStatusRequest
- WebHookRedisListModel
- WebHookStatus
- ZendeskAccountPublicDetails
- Schemas
Add a tag to a return order
Production
https://api.ogoship.com/api
Production
https://api.ogoship.com/api
POST
/Returns/{channelId}/return/{returnId}/tag/{tagId}
Request
Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.Example:
Authorization: Bearer ********************Path Params
Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.ogoship.com/api/Returns//return//tag/' \
--header 'Authorization: Bearer <token>'Responses
🟢200OK
text/plain
Body
Example
🟠400Bad Request
🟠404Record Not Found
Modified at 2025-08-27 08:27:53