Post

1{
2  "schemaVersion": 1,
3  "domain": "blog",
4  "entity": "post",
5  "displayName": "Blog Post",
6  "capability": "content.blog-post",
7  "target": {
8    "classification": "native-plus-cms",
9    "nativeEntity": "Blog Post",
10    "verifiedFqdn": null,
11    "idPolicy": "server-assigned",
12    "crosswalkRequired": true
13  },
14  "sourceAliases": [
15    {
16      "sourceSystem": "wordpress",
17      "sourceEntity": "post",
18      "routes": [
19        "/wp/v2/posts"
20      ],
21      "confidence": "high"
22    },
23    {
24      "sourceSystem": "wix",
25      "sourceEntity": "blogPost",
26      "routes": [
27        "Blog Draft Posts",
28        "Blog Posts"
29      ],
30      "confidence": "high"
31    }
32  ],
33  "preferredWrite": {
34    "surface": "Blog Draft Posts",
35    "endpoint": "POST /blog/v3/draft-posts",
36    "writerId": "createDraftPost",
37    "verification": "verified-live",
38    "importSafe": false,
39    "bulk": false
40  },
41  "fallbacks": [
42    {
43      "classification": "cms",
44      "when": "Use for SEO fields, author/profile metadata, or source-only fields not represented by Blog APIs."
45    }
46  ],
47  "reliability": {
48    "status": "partially-reliable",
49    "flags": [
50      "IMPORT_UNRELIABLE"
51    ]
52  },
53  "pitfalls": [
54    {
55      "code": "slug-url-rewrite",
56      "severity": "blocker",
57      "summary": "Exact original URL or slug preservation is not reliable through public Blog Draft Posts."
58    },
59    {
60      "code": "publish-side-effects",
61      "severity": "warning",
62      "summary": "Publishing imported posts may trigger public publish behavior."
63    }
64  ],
65  "mappingGuidance": [
66    "Create categories, tags, media, and author/member references before posts."
67  ],
68  "setupRequirements": [
69    "Wix Blog app",
70    "Fallback member decision for author attribution."
71  ],
72  "evidence": [
73    {
74      "type": "wix-docs",
75      "url": "https://dev.wix.com/docs/api-reference/business-solutions/blog/draft-posts/draft-object",
76      "note": "object page (docs-survey sweep 2026-08-11)"
77    }
78  ]
79}